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I rod Ljc-tion 

This book has been writlen both as a gamral purpcrae VIC ?ft 
and ^5#2 microprDcessar tutorial in6 is i specific CDinplement \o B,rvJ 

quid* for th« u£e oi i «tt Qf software tenia. Thf toolsi ilong with 
IMs-bODKccMnppiw DevBlop-2*f t prcductDiFranch Silk. Whil* this 
booU i» certainly LAe-ful by iittii, iii viika may tat nagnitlHt 
QsnHdirdilyvi^nLMiilincanlunitipnMI^ TTiefive 
uftwan iDoli »r* tht AH*mblf^ 7h> Kdi^tori The Lnaitari Ttn HonitDr 
and Dvcod^Ti BA^trfiheinolslsdncribfdvidv-tailin ihi 

Mcond stctiDn of this ivxt. CaiH-tte tape la usual dia-tributton 
media for the tools. Howvvert a diaK vcraion is also a^tiUble ai is 
iniMttndid tiaiLn wrEion, Included in ihf bick DMhiibEHAu ui 
eK(±iang« offtft- -for those v/ho wish to L^rafla their loolkit. 

This booK is designed to aatisty the npeds of progr^nimers of 
sevBr4l ItvtlE of exparicnni IncLudlnQ Ihc very ineKperiennd. It ii 
wpltten irittvw H^iprn^ 

11m first uttiori givn e detailwl Iciolra-t tin ardikiectm of 
tht 6n2 miCToprocvMor, Iti uSd^uangBodni I'lqM'r «id 
instructiDn sft an flvanifi»dp The naftrc And structure of data im 
also ixplortd. The introduction to asse mbly language is preEenipd in 
^a sectiDn. 

The aecofxl section is dirvcteb at providirtg informatiorr oc\ the 
uu Of the Eofti^ire teals s^ich arfl an integral par-t of this puKaQt. 
It will bring you step by ittp through -fhie mechanics of creatin^f 
modifyingi running and debugging ymir prngrams- 

Ths third saction Is very VIC-speci*ic. It ppovidit ths 
InfomatLm which is necessary to utilin tha WIC'^ built-in prograna. 
It providH mafflDT/ (naps of aH of ihe VI^fsBASIC optrating syslen 
Along with ths informitlon u to how fo usa scmi of th« built-in 
prDgr>ns> It wlU tell you hdw -to build irurtiiM diaracttrs md bow io 
mate auto-B-Lart artridgea and tn program for gamt paddlesi joysticKSr 
bit'lmAQi grtphica snd to Mhe sound effects. T?w apptndtices conttin 
Additional inforniition or the and the VIC along with gone useful 
tables and »inple programs* 

None of the programs in the DeviIop-2ft Kit are protectecj) 
so you may mate copies fEJT your rwn use. Tnformition is proviiled in 
Chiptif i on MMng bitiOjp copies ttf the so^are iools. You are 
encomgnl to do this as soon as p(»^le as to idirvtify any 
prdUnS with ibe Mgnetkcswfia tdtMn Ihe thirty day warranty 
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period. Vitfi thi axoptiai crFTht LDKmi yduda wt hm tu* 
psripiisstcan 1a r#raove 1he copyright nolke from the coplfs or ib* 
t^f|ihAl. H U specific&lly prohibited to nakt copii-i for rB«lc or 
ioT distribirtion to frisrvds, r<l*iivesi lESOCiales dp anyone tUB. W« 
hope ycMJWiIlrasfwctttielegalindethicalreBb^ctlQns which apply 
tc the tfie-fl D* aoflwipe, both GUhS and evBryofwplM'i. While this 
produd prDvide-5 tools ^hich indH* auch unacrupulan^ activities easiffr 
to accomplish, it it rmt the intent o-f French SiiK th»t you use thssp 
ttnls tor thifl lw. We oppou ind wich ta v«<y strongly diacaurig^ 
the pirating of Mrftvwre. W» would 3l» liKe to polrti out that ther» 
ve HVere pin*ltiH acsocUted with copyright viDlation indudlfig 
final upio Slfl^f »nd inprisonnnnl o# up toont ypirnot inmffntian 
civil hibility. In the interest of prcmo^lng the continued 
development oi high-quality aitd low-coflt Hottwar« the conaumer muit 
play his 4nd her roLes iri helping FLimlnatp ihii saurcf of r«v«nue 
lost to the software flevelaf>er. And, as a -final argument, you, the 
owner o# this Kit are noMr & member of the community of mftw^r* 
developerfi. It ls in all dut interest^ to he^i diBtnrajt iht 
continued growth of this problem, Tharrfc you. 

Many people enquire as to the origin of the name French SiJk. 
ThtfCK Ar« hvitaI raqti- The very first machine known to have been 
invented gt plinel Ear^ with Stability to Eontuni itortd uid 
modifiable progi-am io control its ofwafiori wu inventetf in 1B41 by 
the French silk weaver, JoEEph'Mai>t* Charlee Jacquard. It was known 
IS the JftanJird loom and its progrdms were tnaded » i uries of 
fmnched holes on paper card Si the dominant mean^ Of program storage 
f-or the neKt 17S y^ars. The invention endb^d ibe creation of 
beautiful and intritft-tt pdtl&-rnE in the finest fabric Hfiown to man and 
was the precursor of the moiJern computer. The finalt forcing factor 
tttt? Mitctlan of (he name was the conblnatiDn of Ihe fanbr's 
aumaiM and Ms deKinaency from a line of ulK weavers. (The 
cointident«L existence of a delicious and riift confection by the saae 
name twd nilly vwy Itttle to do with iti. 

The author ^vould liHe to ei^press thanks to Jim Butterfield and 
Ton Court for tlirir helpful MQftntiom and critldnfl of the tarlf 
vereim of tfui teirt. 



rut 1-1 



Ac thii Kit it focuud on the diwloprntfit ft* toftware through 
the o^atlvi use o^ machine languaoe I it will be necesaars^ to first 
underetand the machine before learning its language. 

You'rt ppobibly aware that thert Ifi umthing inalde thi um 
of the VIC-Z* whtdt it ivtown u the dn2 Mutroprocestor* This is- the 
HearlDftheVIC. It is aim the heart of ihe Apple, the Atari, the 
PlTv QH, AIHt 9VMi 031 «nd i ftw cfflw mtcrwcwfiuttpm. Ita f 
praAJct Of K08 Technologyi s ^ilWlly owntd tubtldlepy of Cwmhire 
Business Hechines^ 

The A!t2 li tn inittgrattif arcuit. T^at »r it iE a tingle 
chip of silicon vhlch has built into iXt tort of like etched onto iti 
the ■lectf'anic circuitry which connects thousands microscopically 
small electronic components. ThtH components ere deposited on the 
silicon by some marvel of ntodem technology which it beyond the scope 
of ihit text. Ui won't go intn how the elictponict in [reatid or how 
they firctian eledranicaUy. are Inteirestsdhere in how to use 
this m-uMn how it fits into the enwironmHtt of ttia ViC-2% 
ptrscniAlcoapUtert 

ITi* plect of silicon caJltit the £9t2 is padtaged in a piec* of 
plLstic or ceruic material atmut one inch by two indies. It has M 
little tnig-liKe It gt called pint which nmrct the internal circuitry 
to the outside world. These pint plug into a circuit bcurd which has 
other sinilar appearing chifH of silken, eaiii with Its own set of 
pins and its own internal chv^actiristics^ different from the 
chkractcristics of the 65^2. Each of the chips has its own specific 
functian and together they are canbimdr thraugh i/ntir ccnwcting pine 
and the circuit eUwdontht prantedclrcgHbMPd ii^ ^^t^ they 
are piugQedr to *AKe A flikPOconptrW'. 

TUt wlllbecoM ncn imlimN ^nr u we dno-ib* what 
of the^ ramporiiMft ddpt are for And liow they work end how they 
cntmtJniuta with one another. The description of the functional 
dmcbriAtin of the dStZ will canpletely define the proc4Efar fron 
the programmer's standpoint. The electrical or electronic 
characteristics are of no interest ta ue « we have no ned to 
underttand the jnachme at thit le^L 

The £?t2 is i data processor. It is 4 eiadunc which performs 
siaple operations of liata nanipulatiDn tnler the control of a itored 
pnigra«i Both ifas datauid ttw p-ofpaa sn ■torwl In HKry devices 
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which are inipgrated ctrcutta electrically conrwcTed ta Irte ^582, 
Pr^cion art k sppciaUlssr of Data infl witl f«pliin ppogrims 
**ter wp [1l5£u55 data in i more- general sense. 

tccojrt or ttp gr»de ychir physics Iwcher gave you or IbE pmition of 
PAC-HAH on ycxjT video screen, In-formatJDn, aiii iistiytdinsido- iht 
cooiputer's iFierrarv flevjcis is coded hya Efwcial 5»t nf simolt Pidn. 
Hemory dsviCEi are composed Ihousands of cells, or storage 
iDCJtionSn where the caU 15 kept. Each cell J-5 carnposed Df eight 
EVilchie= whinh cdn te turned pdher on f>r off. tOhen the tatter "A" ii 
pressed- on the ^'eybaar-d af your V|Ci same elpttranc circuitry will 
autDtiLdtically create a pattern of eight switch settings ^vhlch is 
unlquelx i£3flfitifiEd as Ihe pattern for ihp Letter "A". This is the 
cede for "A", (Very character has its owt> code tnJ it is different 
from all ottitrdiardctBr'acodffs. There ire only 25d different 
uniqut Codes which cam bt corKtriiqtefl frpm pjght fiwHch settings. 
There are therefore only 256 possible different charattera whi-ch can 
be reprP^nlPd amJ stored in ths msmory chips of the VlC. Thifa 
suflicient to harNdle A-Z, all the special characters and the 

graphics characters. 

These sw/ilchps are usually tilled "bil5"- Bi* is ^oM for 
binary digit. A digit may have 16 poEsible values, A bit may 

have two possible values, *-|. A bit which is turned on may be 
thought o-f hiving the valup of i and if it is off, it 15 a 9. So 
characters are rtprespnled as a string nf eightbits with bit values 
of either 6 or L. The actnaibi* atring for tfts i^tter "A^' la 
aieaeMl. The coding schenw ligrfiS afiurterr^ijljDral stuwJard called 

ASCTTi which stanOs far American Sfanilard CchJh ^ infarnuWn 
Ints rchari^E. 

Thet5e?'s data link with the memory device-5 15 tailed the data 
bus. This 15 nothing more than a set of eight lines, or electrical 
connpctions. Detwisn (he m&mory chips arvd the i5ft2. Uhen the &S^2. 
under cnntrcil of a prog ram * wishes to either transfer data to or from 
a (Tiemory device, it sencJs anelpclrical signal on the R/O fRead/Writef 
Sinep telling th§ device which dir^ctinn the diXA 15 !□ go. Since the 
ntpnory device tan store thousands o# characters of datai it is 
neceasar? fiar the^Se? tE tEilii whith s-lorage locatiopit wtih« ia 
get tJitd.-fni[riarsenditt(j, It ijQfls th^t+^rougD artotfur 5ft of 
EleEtrical DOnnecfians called the addrBsG Qua. Every ctcragt »U 
kvithin' the Aiemor)' device has a unique address assodateif wi^ U and 
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when the signal comes to do a data transfer, tht mBf^ory device la 
designed to use the irfarm±tian aent on the aCdresc bus to Krw vrhKh 
EtU is being selected. Each data cell tioli^a fight bits 
uifoma^ionL This basic unit of datai ailed a4iyt*>.iB-tramfepred 
ftU el once e]ono ^* eight pireUcl eltc^c*! conOK^AnB Ifrwwn 
cnUectiwlv ai ^ data.bis. 

ThvaddnUtmBiVMrynntiilirtDthcditiauseiiCfpiit hia 
siKtean parallel elBctncal connBctors. LiRa thi data bUEi the address 
bus information 1* coded in biriary. That i»* of thB sixteen 
lines may have only one of \wu possible statpe* a fl or a 1, prispnted 
to the devices as 9 or +5 volts. The buses are conrwcted di.nectly to 
the pins wfiich go inside the plastic package and connecl to the 
interndl micrctirtuitry on the silicon cNips, The 5int§§n bit address 
bus allows ior £5536 different addressable memory locations v^here data 
nay be stored. 

Fimllyr there it 4 tontrDl bus vfhich tonfaina lines whiich 
help to conto^ the varicuv chlfK in tht VIC. The R/W line mer^ioned 
above Is one dfthi cOntrDl ^^U. Uith the exception of 4ha 

interrupt lines^ dissrussed laterj we don't need to knuw much abcut the 
contrcl bus. 

BacAviu the £542 t^aAs4e^^4 and priv^««e4 data ei^ht hl1$ at a 
time, it is Known as an eight bit paralls] processor- The ne<t chapter 
will go into- more detail on the format of the data as it is stored in 
the meiEiDpy devKes. 

Memory devices ccstne in two basic vanettes as of this writing. 
EK3K is md-only memory- Utun 4ie power is tiimed off ROM doesn't 
},tsM tt^ contintK Rtmisa itindiif 'chip which i^dy be 'Read? but 
mrtw^tten to. It»coii^itsaFi"burTWd-in'*attJiefactpr3i'- thM 
ia a liBiWldrirfo* mendry flivice called a which tttands for 

Programmible tntJ it may be irrodifled by a BpniBl piece of hardware 
calked a PROH programmer. It nuat tie vraaed by shining an intense 
ultravinlet light on its top SLrface for some preserved length of 
tine. 

Both C3f these differ from the other main kind of memory device 
which is called RAK. RAK is b&dly nicnamed. It should be ulEed HOM 

for MCWityable HeiFiory or RAW f[>r Read And Write. RAH stands for 
Randoni Access Hemory ■ whicJi means you can extract data from it in any 
uqumct you went. The sime thing is true of all rirrently available 
^p»s of wKnory, including ROM- 

Artywayi Vrm di^r^vea t»tMen»AK aodi^H itttiata proven 
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ran wri^ \o RAH and chafigc lis CDn4«rrt9 and when the power ii tumai] 
off ihe contifits of RAM in lacti whereas F^OH cannol be modi-fied by 
arty pnigr«'n under any cirCLiiri ^atanceE and when the power is turned cffi 
tha t33itent4 0^^ ROM are iKept intact, in the VIC, lil □* the operating 
systfl-m programs arvd the BA5IC intPiT^rpler ar* in HOH. Thil is why you 
can BASIC ppogradis as soon as you tiim tha machina on, witfKUt 
having to Load anything from tape or disK. 
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Bits. Binary digits. Its actually a contrAdiirticn in terms.. 
Binary rrteans it tan have two possible values. Digil inpLes ttn. 

The bit 15 the iTiGst basic L£ut of in^Drmilion. It U the 
Joundation of all otlwr (wr* compleK informatlcn formats. It is tha 
only kind o* infamativi wtiich may be stered in a "digit-ftl" cpmputf r> 
A bit fflsir ^BW "Hit value of tiV^r am or tbtd. A b^te a t^^mpln^ 
at light bifs. Tbm fiStz is called in eight-bit ndcroprDtessor. This 
ii bacauu at processes and stores data eight bifs ii a Haie> It is^ 
tjity^ ainvienjEnt for the purpcrat ui undtrBtLPding the n).ture of 
computer data to brsa^f the eight bits into two four dit sectiors, 

There sre e>:actJ/ Ei>:tBen unir^ f Diir-bit tombim'tioni o+ c™^ 
4nd zeras such that no t-wc arrangements are thMm. There ts a cotnnton 

shDTlhand notation tor icJentifyiig theee sulainpatterra- It ooes 
like this: 



842^ ei:^i 

eeai=i ei0i=5 

Bfll9=2 ajlB=i 

een=3 8111=7 



8421 3421 

leee-e iie»?c 

1961=9 MB1=D 

leiBii*^ 1 iie=E 

1B!1=B m]=F 



It's 1 convienient shorthand Eystsm beciLsi It is sasy to 
reraemOflr. It Bimpiy numbers the patterns from to IS, tiicept, m 
keeping with the idea df using a one character code for each pattern, 
tti numbers t*-l5af*eilleflA-F. SOipatttm 12 called 'C anfllS 
is 'F'l etc. It's got anoth«r advantage too. Thtf «isarthae>d-Ubel 
Eystem has order which makes it aasy to •renenber. If the left-nost 
bit positioi may be consiamd to havB the value of 6; md-the nesi 

position, the valje 4; and the rwiiti 2; and the Last- am then the 
bit patterns may be converted to their labels by aflding the hit values 
□f thB individual bit positions. For EKampld^ 1910 his a 1 in ihe 3 
position, a & in <he 4 position, a 1 in the 2 position, and a # in the 
1 position. 5o itslahelis "A" because fl t 2 - 1* and -A" is the 
code far' ]«. LiKewtsi, «U« it Ubrlvd '6' becauH it has m anp 
*, one 2 and na 1. 
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Th» k^moBt bit poaiUon iscaiwa toe "most-Bigmficim" fiit 
tttcflusp it his tha gr#itBst bit wikwi IlAft-il^ncUlttl *h* "high- 

Drder''bit. Litew^e, (hp rightmost bHia fte'UiBl iSQrtfijnV a- 

"lowcjTflerbit", 

Ncte Ihit all 1h& add numbers have i one irr ih* pigMiicst litt 
PDSitiDT. All tti* evpn numtie-PSf a zero. 

You can now He thai the skiorlhand no+itiDn *or identifying a 
four bil data *iBid is very logical, and it ls not hird tc convBrt btcK 
and ftrth twlwHnttiihitpilttmeind ths paittm code. This is 
uiipm*t4nt ■h*<iua< machine lAnguags progrimmBrt, we havs io erxf 14] 
wartdng' a tot wi-ft^ ti.it^ . ThifliE btta™ 1h* «*r i.nd all oi ft« 
memDTY dBvicu itore imS writ with lU dati coded as btt«. 

ThB addresaeso* whers daU is locifpd wilhin* nwnv^ devi» 
is likewise pepresented snd tnnsforrsd on the address bus irr bits. 

Ho^, since dati is storpfl and pctriavad to and fron the m»»ory 
devicES eight bits at a time ( tallfld a dyte n* data )t it taites two 
Shorthahd tCKJes to describe the *i1 cpntent cf the data. A byte ot 
data which ftas a bit structure D-f 1166 9 wouid be ifl-entified as 
having the twc-ciiaracter code af "CA". The bit structure ot the code 
^□P tl» lPtl?r "A" wauM bp "41" because the bit pattern assigned to 
"A'intht ASCnCKfliTg schflne ii..6l»0 Wl, It's helpfy] to sit with 
a pencil and pap#r ariflwdte airt bit patterns and fiflur« tuft w*at 
ttielr codefl ar*, Yxiu should ilso <laPt with the fodsa (-F and ctirtveri 
back to bit patterns. 

T^at there are 25^ wiys tci represent -^igh't bits is obvims 
+rom the fact that thpre arp 5.ii!teen pM^ihle first characters, o* thi 
two character code which Identifies an eighl^bit fii-ttern and 5i>fteeri 
^^Clss[ble second characters. And 16 limes 16 = 256. T+ we wanted a 
bj-te o-f data -Id rffpresent a nunieric /aiup instedd of an ASCII coded 
character p we car* see that it ccuLd represent any value between fl and 
255. 7hB iiS#2 davi>i in fact, sometinies treat data as it is nuiripric 
iPstMd Df tftaractep data. Using tTie saflie two-thiracter code to 
xd*rrtHy anB bit pattenv ve carrconvert between ths numeric value 
antf thi tuD-draractep codequite saeily, Fw #!^iFnpl&, to fonveM friiii 

"AA" to its nuineric value, we would (nultiply 11 times 16 i "A" = S« 1 
ami add 6 to give 166. Lil<BWiBe, to cdnvirt ''4F'' to numeric we vaAS 
muJtiFHx4 timts U and add 15 CP" - 15 ) to give 7*. It'cpi5y to 
see that the iria!<imu(n vatiw af "RF " = 15 times lit I24ffl plu5 15 to 
give Of coursei the minimum would be 'M" which is <t timea l^J 
plus 4. 
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How jUmut going the trthtr way? If w»nt to cwati lh 1 hit 
pattern for aome number in the range of S - ZMt v h*va la 
divide the numbar by ii to g#t the first tharactor of the code 
(remember to translate 1# thru IS to A thru ¥). Then tlie re maimer erf 
the division is the second character. Now to get the bit pattern we 
just IDOH it up in the li*tle bit pattern table. Put the #ir5t fou'- 
bit pattern together with the escond and you h#ve an eig(\t bit pittern 
which repr*sBnts the fiuBreric value. Kot hard at all. Lets try it 
ttittl*.#ewnumbB«» Take tfie number lfi9, How iHany times does ii go 
Ihte 1*9? Ritfit, fiirti how is that represenrfed in our single character 
cbtte? As ttW latter "A". The remainder from divittir^ ifi^ by I A is ?. 
So Dtr chif irtff^cDflf reprvMHtatlofi erf 1 fi9 ii -A?' if we go to 
the bit pattern table, we will see ttui thi flitpttttifrH ar* 1«1» 
IHl. 

It IS a valuable eitertiM to practice cDnvertirg bit pitterm 

tn character-codes and trom character-codes to decimal anfl from 
decimal to character-codes and character^codes to bit patterns. Vou 
will find A table of all 25 j bit patterns anfl tfie corresponding 
character-codes and corresponding decimal values in Appendin B. You 
r>^ chedt ypur iucuss with the table. 

Tlw ^Ji4racter-code system #or nJentifying the various bit 
pattw^iHt " mlahtttiow oThave figLred out. what ir computer 
dretei it tallri Mh^decltniU Numl»P«, when represented in 
htxadecimalp are iHually pperqeded hy a t41 js tb« ^ 

represenlation *or the ASai ccxle fcr the letter "A", This rvif>Ovcs 
any t^estiDn as tc whether the number is daciniil or heHad*cimal. From 
now on we will follow that convention in this l»*t. 

There ii another conventicw which is wtdety used to identify 
Ihf individutl biti in a bytt. The bits are numbered #-7 froRi right 
to left. The hiah-orfler bit is the 7-bit and tbe low-order ttil !■ the 
•-bit. 

J* diwuiied the vay to npr#Hntthr[fe«mil numbers from ft 
to^^ ThB ^ue general techniqije may be uB#d tD represent numbars 
frow I tn iS535. IrHlead of two he^ character* representing one byte 
ofdaU, we neei} four hex character! refr*»nUng nxtttinbttl or twD 
bytes. Now the first pair ot hen characters may toe followed by *ny of 
256 pairs erf hix tftaractepi I i«0 - IFF J, Sq the total nunfatr erf 
possible combinations of far hex characters is 256 tjmfs 334 tr 
d553£. The address bus ii sixteen bits wide. Which is why thtre ar* 
»4Ctly 45S3fi urbqui Addresiec pmlblt. How, it ia fr«iiMiilly MthA 



iMldtTlw VIC 



10 b« iblfl ic zonveri d«ciinal addr«su& inia hE>radf-cln«l. U* saw how 
^ ito H with d SiTiglfi bylfr of -two characUrc bifsl. U|> 
divided the -number by li ia gei tfie firii ch-araf-t^r tnd flw remAindrr 
^vd^ the Hcond character. The prcaass is eIiiuJeu- for qoinq (rxm t 
number Urgsr ihm 255. 

OiviCe the number by 254 In get Ihe -TirBt half of the 
anEwer. This will be a numbar iteti^ppfi 1 and 2^5. Ttie remainder wi31 
bt the s*ccJPd rtal* of the inswftr* Both of IhsM dadmjl numbepc nn 
than it nmvwtBfl -to tMir tieniiKcimftl cotrrterpirts by the dividing- 
by-i£ "tvdniiqtjei Thu« he->; Eti^its can be then easily -convirtpcl to 
biiv tbinarr* by Iwlflng upthp fable or retrieving it from our 

bicslcgicdl mcFnory device. 

Le1s do an e>:fl[nple Say want io gei the binary value < bit 
confiquTflticin ) of t'le decimal number Th& -first thing vfs do kE 

5ee how many limes 256 will go irrtD 47692, The answer is 187, The 
remairdpr i-s SB, A line a-f BASIC code toflo this cnmputation would 
bi: 

HA-JKTCNUH USA HUB- HUIi-HA»ZM 

HA is the first half of thp answer in decimal. HB is tha 
■SECond half, still t«ve to tahe 18? and 2ft and lireaM them into 

their two hej coinpanents. Ue do this tiy dividing by i&. 167 Mfi = 

1 1 w/i-fh d reiTiainder of 1 S . So t^ie fifsl two heti digits are 4fiB. 26 / 
16 - 1 with A rewiiinder of 4. 5o the complete answer is tBB}4. T^e 
binary equivale'nt o-J <BB1 is 18 1 1 J&l ] flft* 1 ftiee. To double check 
BUT anSLjpr, we go bacK th-e flther direrlion and ranve^l *BBi4 to 
tjecimal. »t4 ■ ^1 * Ji) + I = 28- »BB" (M*lif+Jl = 17d*n 

■ 1&7. UB7 • 25(4 > 47972 + 29 = 47&*2. And that's the 

rurotjerwfliaMffdwith* Tflii ppoceM sJ»iitdb» |w*ctici[j. Ills very 
helpful in solidifying ^^e understanding oi tiBx and binary and Iheir 
rtUtionshipE to diEjPial numbers. 



The 6^92 IS a nachin?. Its jnoviriQ parts are electrons and the 
only wchS? it does is with data. It has somt internal data storage 
which IB iflsntical in netur-e tn ttie data storage in the flieimary devices 
to which It is -attached through its external connectoTE. The internal 
storage is Known as the machine's registers. The registers eight 
hits wld» and theft arftonly mwfl irfti»Jn< Kachr^>Bl»rhas. some 
special charic^lstin in thf wiy^^d50ZC>tn uta3» -if\t datd 
contained init. Tlif del* iy«esHBby this michtne ts «Di^d in Ihfi 
ti:t»mal memory and the registers. Processihg con^stB at 
n*nipul<ting tHe datd in some logical sequence which results in 
accomplishing same desired goal. The 6592 processor does its 
prcKestirtg of data by mterpreting and e^;ecuting " instruct jon'^". 

Instructions ire tiiX),. They are stored in the meinory devices 
as eight bit bytes which are precoded ( progra-mmed ) tn make the &^IA2 
do some siesirpd ctperaljQn, The first byte of Path instructLon is 
called the Operation Code. The £592 has pre-programmed circuitry 
jH^ltin to ItE pnirrulBctonicfit atchEd onto its silicon ctiipr which 
can dttCQd« operaticm codes s-nd figure out wiiat it is supposed to dO 
ntfVt based on t^bit stiuctunof thei^3eratiQFL <Dde, This Icgii: 
cDeiEe wi-^ the 6St2: l^e tright electronic engineecB who de&ign»d the 

65%2 at rtOS Technology bacK in 1*?75 figured out how to rnaWe the 
interoret bit structures and to take whatever action each operation 
code was flpsigrw-fl to maHe it do- They prepiarined a ^et of data 
manLpulation onerations -wTiich they Itiought would ba useful -for a 
microprocessor la be able Io do and then set about designing the 
machine and the □peraticn cijdes go that tho^e operations c-Quld b€ 
interpreted and pe-rf armed. The way the processor is tjrogrammed by you 
th-e pragramm«r is -for you to place in tht iritno^ of ihB conputar a 
sequence -Qf Infitmctions dflsignad tti maKethi d5B2'dD schh presumably 
uM-ful tasK- You chDCfse the ih^tmctioriB. cAreM]y from t|:« ut of 
ivailable instructiong Which Ihe fiSfllmperfora. You code these 
instructions in the language whi^ the ma^nti can LFiderstandi machine 
lartguige. Each mstrjcticn has a specific b5f pattern which ts 

understood by the 6^ez tn meir perfar^n eom» operaticmand ute on^ o4 

the i.3 addressing iriDdes- 

If ycnj have an assembler you can write the 6592 instrucions in 
dn undpratandflble format whicli makes somr sensE to huiiLans when they 
re-id itp The assembler will then convert the human understandable 
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prograin into a inichirw undarsartflabl* «pguer>c« o-f biH patttrns (byleaJ, 
The A?ssinbler suth 4 pfogpam *on tht VlC--2fl. The ne«1 MCtiOfi 
tella ycu how to uh In this saclior we will ■>!plar« thv 
6^e7'archrtfccturEi its rEgistcrfif it^ instruction Hi uhI its vuious 
addreeelno modes- Firsti 1hp registers. 

Th* Pra^AB Qurtvr 

Th» liS-btt Prograifi Counter RegiateP is ictuilly two fl-til 
registers* the PCL and PCH regia-fcEfs. These two regiEtart tn alwtyv 
utttf u 1 piir. Thv ^ PCH" s'tAnds for Prograin Countsr High md 'Pd." 
stands for Progrdn Counter Low. Togetherp they irs Li»d by th* 
to form a -£i>rt<en bit addr-ess poinier. Th? £^0? moves the contmts 
these two registers to the address bus i^her it wants to fstdi an 
instruction from some mernor/ chip aHached to the 

The Progpafli Countpr tells 6502 where the np^-t inEtnjctmn to 
br E)iecutBd is located in memcry. When the computer is turnefl dm, an 
initiahzation process occurs autoirratically. This process incluctes 

moving thidaUomtianiii in-iili^ssestFFFC and tJFFD birictly intn 
the PCL trtdPC^^apttctiVfl);^. Adtlreana sudi as thi? which' Are stored 
in iTiemory and pQirrt'toihe^tartipg poirvt of sons other program ar* 
called "vectE^'i ThUiBhaw thfl=ASS2 finds the adbrtfliof its first 
instruction to be executed. So, every 65^2 must haw thv addiYsfe 0^ 
the beginning of Hts first program fo be eveajted pr«5tar«d at t^FTCt 
t¥¥¥D. Thi5 inu5t gtviously be in ROHt 

This initialization process occurs at power-on tim? and 

Whenever the RE^ETbuttrvi (av4ilab1^ ati satf\$ «>ip4neion chA«»« biit nat 

on the stanilard VIC) is pushed- A-fter ?ach e>:'?cution cf an instructiDn 
by the £562j the Program Counter te incremented to the next 
inEtr^etien, tnd so th« {roorani flow nrcirB. 

Hi* Arreg 

The A-T«g nay be thought of as -the ArithseUc reoiBter- It ii 
often called the Accumulator. LlKe all the regiBtBrs. ft ie a one- 
byte IS-blt) register. It is tlie plats when arithmetic operitionB 
near. Instructions like ADC ( Add with Carry > and SHC 1 Subtract 
with Carry) cause data to be added to or fiiitracted from ^e A 
register. The A reg may be loaded (new value brought into it) with tn 
instruction such a« LDA (Load the A-reg). Its contents mty be stored 
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art to some memory iDcatinn With an instruction such as STA (Store the 
A-regl- The AEldreH in niJnory Where data is loaded-frDm. and stQr<d-to 
is specified ty further addressing informatiork provided to the 6592 by 
the progra-m in a inanrer discussed in the ne>!t chapter. 

Reference 5 to "STA" or''LDA'^ instmctions are reterring to the 
assembler language English-like mnemonic wh-ich gets translated into a 
nachifw language instruction recognizable by the There is aorc- 

kr one carrBcpDndenct bitMm tfiumbly languagB stdt^rranta and 
RUhiTM language instruc;ticins« 

The 1 nil' rtgnttn 

TlierE are two other 'woHting^ rcgistflrs called the K arrri 7 

reg:stHf5. The^e are also Known as the intlcK register^. TSiese aU 

pjflht bit sturag? regiatere in the ^SflZ chip itsel-f. The J( and Y 
registers are used mostly in addressing ^uictjons as e^pliined next 
chapter. The X and Y registers may both be loaded iron memor/ with 
instructions -such as LDKandU)^. They ma> Qe saved Utorsdl in 
memDry with STX and STY instructions, Ttiey may also b« lncr«Btntt<li 
deo^iientedi and compved to Oata. in eMtemal memory. 

The second 256-bytK blocUof memory ft«l6a-(#LFF> is used by 
the 6Sa7 in a special way. It Ls called tn« StAcK. Tfye StacKis a 
special storage block which is autoinatic ally utilind by ceHain 
inabTJctions, Its primary reason for existence is to allow subroutine 

'msting^ and "to ellow for the am«th handling of interrupts. 

StAroijtlrws an prolan segments whirh can be executed by many 
difftl^ progriftft. They sub-programs, <nihicti are iimpe d-to and 
rclotTCd-frtTint Thvy Mving towute commonly used program 

segmentspvePandow^gAin- The tta^ Is the dH2'« ccimnuiicetian 
medianism forpmnbttrifig a idirautirw Mi"ciUBd' from. The 
JSR (Jump to Subroutine) instruction is ex plaimd in lietail in Chapter 
5. Suffice it here to say Vial the J5R causes the program to junp to a 
wjbroutini in such a way that the subroutine can retirn to the 
instruction after the JSP once it is done doing its processing , The 
ii92 saves the return address on the BtacK when a JS?t occurs. It 
pulls it off the stacK when the FTS Iretum from S^ijrojtinil occuraT 
The position of the next available stack location for recordtng return 



InndvTM W 



iddrEEHB iB Upt in th« SP. Th« is Erdtiallzrd by thr V]C s-tiM- 
up prograir to ths v*lu» □* *FF *1 power-on ind HK SET lime. Thfl hioh- 
order byie oi \he atacK tddreis ie alwayc (Bl, Thii is fixed inida 
thft 6502. Th» -first time a JSH infitriictiDri axEOJtfid, the iddrflM 
of irfhirt tQr«1iimtoispuihedDntDthE&tAcKatt«ijrF ind >eiF£. 
Thf 9P tfffi jgo ■i M i iL id by -twa w ihat tht new vah» of lh» 5F ii 
ttlFB^ Ttw ninfAitin* cihtdby^ JBI) My thwi uU iddi-tivul 
ndvautim tnd ^TtlumaddrciavawiU WstondbaW tha uiitiaL 
ntum uldr«s»' TH«r* any h^t^iolTB livalc of EUbrnitim uUkig 
Ather subroutirwa. Each Eubroutirw nuGi havp 99 its lait i na trije U m 

load thtf PC with ths saved ■ddr«fi ^ron ttia stacK ind to incrtiMnt thf 

was calEtd. 

lntBrnjpt« are cauud by an t]«ctrical signal to the £542 from 
thf outside world. Therv aro two intflrrupt Liwt ittuhed to ihi pine 
of tht 65«2. On* of thtni the HKl liw, will cauu th> 6^^2 to bm 
inttmpted regardlesB of what it in doing. This called ihe Kon- 

HuKAblr IntuTupt- Tl^r ftdlitf it priMdsd Vpihit lopiJWftPr 
hai critical tinlna r«qulreiMrrts«Ky cuna ^e 4i5fl2 to urvia 
innvdiatily. H if. Alao providtd ai a nwars of uncenditlDrHHy 
bn^Kinsi into the imniiing oi ttw nuhlnt if it U Mpidrt ttii4 
sonihing hai gone awry in iproQranBnd then ii no other W4y lotitie- 
control ui the n-achlm flhort of timing if crff and turning ii badk on 
again. 

Th* other kind oi interrupt it 4 misKable interrupt. A meane 
cjiiBiti to pnvenl the interrupt 4fom b«ing lerviced. An interpi^ nty 
be 'naEked" (mitfe tto it can't ba eeitn the AS-tZ) by the mttna erf ari 
"intvrftfrt diiable- bit -in tha FrDn«Kr Status re0steT. HaiKabto 
inteiTupta iPttofiM wbpw lUf^UCDnrwctforwaPt toQvi IRQ ptn 
ofthiAHQ. 

Arthkinde of l^ittPf^jtB^antiandlvdin^eut IIh b^ 
ihi dSflZ. The 63t2 finujmiFDaHingihBihi^vcticnwfiith w 
pragr«» when the interrupt signal was rtcogniied. It then saves the 
PC on the Gtadt Just as i-f a J9R had been executed. Additionellyr it 
Hves the Procc-aior Status Rrglfitar DO tht fttacK and decnmenti frf 
stacK by three. H now laad^ the PC with the address found in 
location IFFFA and *FF7B for a HHl interrupt or IFFFtt and tFfFF for a 
riiTr-n«s'U4>l« InteTupt. Thiw Im-tiar^ muit have been pre-ppagraeimml 
to contain the addrtnes of the programe which wer« written to earvice 
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the interrupts. 

Thr interrupt procrsHng rwtJn»sini*th»exited via a RTI 
instructiDn tRetum from Interrupt). This, acta lite the RTS 
Inctruciion except that ttie Procaseor &UME1««itUri«rtlHd«I fnm 

vtackbafoTB tht PC is puUtd fn» ttt* vtai^ Iri this fUhloni 
the imefwt»dpPdff^eTMTcontinuBWhtFtltvTOint»rr^ 
KtatusDftl^! nuhiWutilhtuifwuit ttntiiit ofintmjptioa 

ThB stack is also used by tht PHA and PHP instructions to 
store tht A-^eg arvi the P-ng rnpectively in the stacK. 1^is ie usad 
ta piu infornmition to tht nbroutlnt. Hart ififormation about thtH 
iratnxt^ons may be fomd In Chapter S< 

Ttit Pnmtor stttuiflvgitlir 

Tht ProcBEur ^atus fieglcier ti a collection of eight MtEf 
■omtiDfscmEd f^agii Whidi rtfltctuMf mntroi tht ciperatiDnVf tht 

P-regbtt position 7&S43Zia 
StatuB-bU label W BDIZC- 

Ifie Megatlv* ttt 

"N" is tht Ntqativi-ait. It it tjmed on by the prttesaor 
ta»ri the eHacution of certain instructiona. It refltcts whether tht 
resLilt of an addition or ^ubtracUtft it nega^iva vt not. A i value in 
thtHtgativtbitindicattttri^AtivBtequiti Thi^bitt M ftt by laad 
instructions and campart 'imtructiDns too. Sn tht i^uptar tha 
i5%2 Ins^truction vet for a conpLeta ailplanation of tuh inalnjctiai an 
how vach affects the vviva ttt^ bitSi 

ITie DvtrflDw nt 

The "V" bit IS tha overflow bit. It reflects whetFvtr or not 
"two's CDmpiement" Dverflaw hae resulted from i SBC iSublpact with 
Carry) instruction. It is also set by the BIT instruction. Seethe 
descriptions of those Instmctions for a nre camplBta explanation. 



Tf^fl "B" bit is set by \ht prcicBBHCjr when a BfiK instruc^tcjn 
fi^ecLrted- The BRK inatmction cause-E in interrupt to occur. It is a 

fiDftwAn iniEFTup'tf usrd mostly in debugging iDichirv languaoe 
progrftaL TTu BRK uittrr^stiBproasHd olimnt lite a iruEMsto- 

Inttmfrt pramaHnsi routine. The only .wiy the ^iracHtlng 
routini »n Itnow H (he tn^rrupt wu a softw -ve cr hartfwu^ int*m«i1 
im by BxiFnining -the bit in the Prb£»€SiOr SUIufi FCQig-tftr which hu 
bBfn ctprBd on the Etack. The B^k is not mukablei but it i^hs 
mABKAblff intamjpt wctET. Also, the return utdrau Etored on thi- 
ituU if thf adi&vu Df tht BRV LnBlructim phs -two. 

Ita DMdMl Hodi Ht 

Th»"D'^UBiath«P-™gi»*M]to.tbtppii»^^ ill 
AIX^ 4Jid BBC ina^UiiiarK inCvdinii nmdv. In decitBoI mcder the di^ 
brk^ Addtd «r «ubt3-tcttd ^tfiUlif AUtiiMtl1at» tonpcwii of tttQ 
dacimai digits fMrbyle. gii^iiji|)itt«cwl«d u a -fbur-^ f^tt«^ 
having nngB of valim te - )9. nngi of viluev v^id> ttfi be 
Lontaincd in a byte is dtdm^ Tha mnw trf th» dft^i typf is 
fiimry CoQed Dec! mil <BCD). 

U the Decjmal mDdo ifi deip, the ADC irid SBC inBtructwPis 
will tredt thp dati being added and subtracted la eight-bit bimry 
valiiBS in the rmge ^-255* 

The "D^ bit my ht ut Lnd diired by the prftgram untJi SGD ind 
CLD inrtmctiDrw» 

The ^ig is the ihterrupt-tlf hUb fliQ. It ffliy be ut with 
the SEl irwtnjction ind cleir»4 wiih the OJ imtrwrtfen- Wnn «et, 
only ncr-miiKAblr imt BOftwin inttmipts B*f [KM<. Wtwi Cltirr 
inten^rtfi art enabled-. 

ThvZflTDbit 

The ^T' flag ii like the "N" +1^^^ by arithmetic And toad 
and coB(ure infitructiDnE.. Utht^BUlt of thew OfwratimB gives a 
»ro Ptsult, the Z-fUg is tef- Oilm>wiH it is Cl«red. 
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HwCvry bil 

Tti« 'c:' flag istheCerry bit. It i« set by uMitiont 
5ub^ictiDfii shift *nd compire imtructianE u vmU Mthe ^wcitic 
sec and CLC iriEtruciiqnB. 

The Ni Vi 1 and CbJteeiay^ bH.fntidhy E<nc|itidnU branch 
tnatriJctiDns . A. -full explaneliii^ of fftCi^t/ it fro^ed in the 
foUowirtg cha|rterG. 
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The inslructiors within the prograin which coTitroJ the processar 
cause it ta ei-ther- If load data from iremDry into one □* iT5 internal 
fegislpps or 2) to move Oata trom wie register ■(□ ar»p1fier or 31 Id 
slore data -fr-am ctne the registers into mftniDry or 4) to modify the 
data in one of the regiiters by soft* inthmelic opsraliGP or 5] to 

cauM i ch»ngii in the flow of m proytm- 

The ftSA^j iBit dBKid» HEhinstfiKtidnifterhaving fctcM 
Ff&m nwrnor^T *i>«DVBrfi^+irflB thines ahou-t the instruction: i\ +he 
numbBT uffry^lei th« instruction -lite* in (nflmwyi 2) t^e iddrsEsing 

made o* ttfp irstruction; 3) the opsritinn to bp performeb. The 
tiperitiDn coda tatoa only cne byte for every instruction bsA ^iliflfl- 
instruCtlOTS ne?^ to supply the prncpsscir additional in^nrmatjm 
heyiM-rd IhB op-ctwle. Thit it cither address anformation or data. Hi 
tor example, aninstfuction's pu'pOM IS lo direct the ppocesaoT tc 
store the data contained n its A rsgister into soft* iDcitian in 
memory, it needs to provide the the in-forinatian as to where ±a 
ttDW It. This could tiKi orw DT two additional byin dtpanding on 
4w Uhlresitina mode. 

filth operation code ha5 coded into it the irfornaiion as to 
what aiMrtsBina node shEXjld be uted to actomplish the dew-^d 
openticn. The £S<Z fiai thirteen addreBsing nodeS' 



ABSOLUTH MODS - Absolute adress-mg requires a three byte xn^tructior. 
The *irst is the op-ccdt arwJ tht ntv± two tra the two bytei of addrsst 
infor ntaticHr 

You recall that it taKii two bytea I sixteen bits i to 
mpecify w »ddr#H in th»iM2 widPtM space- Thli ii hecauae the 
ftddrvst bui it !u>:.t«en.fri«fr B^de. The firvt byte of tfw two byte 
AiH^n l»c4lls<J high-ordi?" byte op the BOBt-BigntlicarTt byte of 
the iddrtH. Tht Mconi tryte is the low-order orlaast sigruficflnt 

byte- These are so metimes abbreviated the MSD and the LSD. The 65i2, 
when It avecuteE ipitrucljonft with ^solute addresiing, simply tttchet 
thentiJt two by t*s after the op-tode and pyt* them on the address bus 
when it does th* memory access operation speci-fied by the op-code> 
Tft« iMiPory devices, which are attached to th# addPBsfi bm and tte data 
bus artf the CDotrol b.«F ar-sigmleiby -H^p/WsiflnU artf t*l» the 
aOtfreis informatian off the address bus to Hlect the mtWt locatim 
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to either store dat-a into or read data out of . If the R/W signal 
Qigmfies WritBh it vvill lake the data from th« data bu^ Auii ^iart it 
inia thi ifiePTiCiry locaticn specitipd by the addrpsm an the address bus. 
14 it 9 Ppad signalt 1-t Will taKe the data already stored at the 

specified location and load it onto the data bus ^ere the will 
-find ttjnd do *rfiatever the Dp-tods incfic*l«d should be (jone i«th it. 
In ^bsD^u^e modei the address is'itnred after ^ht ap-cjodt witlr #ie 
]ea^t si^nificani tiyit in^ediately toUDwinq ^ C'p-Eale and the ffwst 
Bigru^^nt byte ft^DWing that. EHanpla: 

ZICS AE 21 45 

This IS an e>:ainple ai both an assembly language statemicnt on the 

first line and the machine language -following it- The format is th? 

•iiine that which atP^ars on the Bcreen when you rm The Asiembler. 
The a»«enb])> Lvifiuaae mnerM]nicifl:.LDA. It ie the uHiMily Iwigiuge 
equivLlpnt i>4 the Ofi-codib It mnm LtA^ thv A rpgiater. Tn« 
AswatiiMPt yMish nmv«ii usAidi^ Lviguj^ ^o machin* Ungu^} 
decajfB trw Bnenonic and tht following operand and produEes t^ 
madiina language which appears or- the second line. The Assembler 
also prndijcn »»ettv or dist^tte f^le containing the machine 
language which The Loader can then read aruj store in the appropriate 
nemory iDCatlonSi ^er» lifidlly it can be »M*ciited as a ^Dgram. 

For now, lets just loah at the 1img statements as titey app.ear 
here-. The »4521 15. called the operanff -field. It specifies to the 

6542 where the dita to be Loaded into the A register is to lie fDund. 
The is the addnsBwMrathe inMructionit Jocatad. It wic 

arbitrarily picked tor *hl» e)i«Bpl»- Thm second field, •ADf ia the 
hex repmentation for the op-codi. Following the op^uxle i« %2ii thv 
Hcond byte 0I the address ^pecfied in the assembly statement above, 
tt IB followed by a45t the first byta of the address. TKis is the 
order the ±502 eKpectslallnd addre&seSi The £342 proi^es^ea this 

instruction when its Program Counter tias the value of tZftCft, Jt 
-fetches t^ie op-code at that address and decoder it and B>[eciite5 it in 
the -FoUowinci sequence: 1) 3t determines froiri the qj-code of IAD that 
this IS an instruction to caiise the A register to bp Inaded fr^m a 

l«atiM whnu address it will find imnc-diately after Vva op-cole. 2^ 
It fetches- the nevtbyte after ttie op-codai and puts it on the 
least BtBnificant byii of tt« addrcas bis- 31 H frtttwB^ the next 
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byte, >45j and puts it on Iht mosl Eigni-fmant byte of iht tddr-tfib 
bu5. 4} It the R/W bne lo R- h Wditfi for ths iriEnDry Os<na 
to get the BpecHitil flata arm put Jt ix^ the data bu*, 6} It r«&d5 
the diti -from the data bus dnt3 ^uts it in it« A rvgistpr. 6. H 
i-ncn-a»s tt>r PCH,PCL register pur by 3 » thil it now points to Ihe 

This i« A «fflpl»t* insfaidiflri tytl*. 

ESRDPAQB MODI - ]f you tatfe the si^rt^^n bit flddmstaus^nd splH It 
ift f\iii, ih» #igM bitt coulil Ihought of as a "page numbsr" and 
tlis eeconcl eig^tl bit; cculd tKen represent the addre^^ 1 from 4 - 
2^5 ) 'H'lthin that page. This- would meari that there are 256 possible 
pages, esch MJith 256 memory localions. 7§ro Page would then reprpsent 
all i^efTiOry locatiors -from *eft99 to IBflff {0 to 155 J. Page o« wmlb 
inmectiat'ely folLowi contuning ^ addmse^ >Bl0fr MIFF (2Sd ta 

These af» Iwo pages iwhich haw* ip«i4l &gni*K*nce rfur- the 
£54?. Page lera addresses iita> be siMEcilifiri vith cbtWtl inddrine 
languaijB irrttmctions which art specif ically coded^ as l^n Pic^e 
addresslr>g mod*. Page ane tipsignated tiie stdcK page as eirplairwd 
ir the pMViOtJi (hapter. More about that later. The designere o-f the 
6562 decided it vculd be good to have an addresairkg mode wh-mh allowEd 
t^^e 6562 to eKecute inttruclions faster and would con^me less meniDry. 
The Zero Pa^c addrc^^iog inod? wa« part of the ^olutLon. The 
addressing modr is specified as a part of the op-code. En decoding 
theop-tode^ th&^Z, upon deitrmining that the addressing mode is 
iPt ihi^ tawn frullhi iddrtsslo i(ts»Md tsin zero page. It 
ttierv-fbrv-hu^n^ t(> ^Q*-!^ wBinprv byte of wldrcHslng datai thE low- 
order or lipisi-siOnHicarit portion of th* addres?. Th* higti-order 
half oi the addrtss will be forced tQ m by the 6^92, ThGrBtorcr 

Z^ro Page jnstnjctiona are only two byt?5 long; the op-code anc^ th« 
address -within zero pigi where -the data is to h* s-tored or JouniJ. 
Ci: ample: 

STA ^17C 

Th# aefl-imw U th« cede to the iSHmbler Vtui Ihtt » a laro 
Page inttrucTtioFv Ttw aflUrsss-specifl"* *hi opflrand is *«7C» 
tidft is a StOTf ^ A-r*g iniFtructibn. Dp-uMfo 165 ugftM ^ 



MipTfW VIC 



Pi«e4-4 



corrlents of ihe A-rag to be stored irrta the spedflftd zero page memDry 
Idution (»H7C ir> «4s ample). 



Iht TWHlvd'clata fanediatel}^ afttr the op-code rather ttian having to go 
ta lom 9pecifi«d addrm io find it. Thiu are two-byte 
instructions! dtw for t^e op-codei one for the -data. They execiite 
even fa.ster than the zero page instructions becoLFse ihe 65^2 needn't 
put anything on the addreaa tiia or wait for trother fetch cyde to 
complete btfort i1 gats the data it needs, flxample: 

BBC HZS 

NcrU han tfaftfiVw Dpvriral litfldfrnKK" prtcirding tht dili 
valtfe. litis iK th* cod* ta The AsHnbler ^1 this is in KniiWt^te 

Hodelmtrtictlen. Re1« alutrut no "i" pw»d«ttwvt]ut^5. Th» 

Assembler recognizes four data types, dedmali hehadffcimali addresG 
eKpression and ASCII character. He:< numbers are indicated tiy a 
l»dmg "I". AGCli rharaftgra by a " ' " dndmal numbers by a first 
character of 8-9, and addr*5S eKpressiona everything else. In every 
casep The Assembler will convert the specified data value into binary 
(or hpx if you wishi t^ie Ehorthand notation ior binary) w^icti la aU 
the 65^2 can ultiniatily mlBrEtand. The second line displays the 
nuhint l^^guaflv in the same fonnat as- before. The first field is the 
addrrsi in htK whrff the instruction will rDoidej followed by the Dp- 
code in hsK, followed by fin ^ta valutinheH ^-vo, ChtcK for' 
yomelf that iit is the same thing as decimal !5. 

The AfWinbler has an Dption you may stlect each time it is rur 
to print the addresses and generated machine Language in eithsr 
dtCLFTiil or hev. Tha file which is created tat loading by The Loader 
Willi aliwflys contain henabeaniil. 

SBC stands for Subtract with Carry. Itisan instructian to 
Subtract the ^cified tiiti 'jH^ (ron the contentsof Dm A-vtq and 
to store the result bacH in the A-reg. 

One further note: Most instructiDns may be speckfled witfi a 
variety of iddrs^^ing modei. The AuerabltreKaminia the optrind field 
to deternine yhich addrasiMna wde 1% b«ing ipui-Hitd- It then 
generates the pn)perndbnaUrKHAe>cvr-d]detaih^ bntb tht 
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Dpr>raiion to be [KrfDrnied ind the iddrcssirtg mode. As an BKditLpler 
"SBC IS dn ab^otutf madi uflreior cf the SBC instructicn and the 

□p-code iorii is SSD » Eonporett with IS9 is in Ihe Above ejfamplt. 
Apf»rdi>i A cantAins a listof ill imtnictiDns and their tUirwiUe 

UmiKD HCniB - Th> Inj^id i^ode Df addrcBSifig is ^ f JkaievtBMKuting 
ami thf BfiDrtVBl In^trurtifln- I'mgthj In imp^iMi} mDe^i only 
tnternilrcgivttrfl Df ^^^2 bre-«d^^rsHd. BGwmd :Hir Dfrcudik no 
WOPS infdrfflition jtreiTiJirHl, w impiW mod* oril/^ taKei one hjit. 

Taj: 

fl23F AA 
TAY 

TAX ciuM5thtcDnt»nt5 0tTt>«A-™g*Bfae tP4TwJFpftdlb fte 
X-reg, TYA t^uwa the OTrtKttE tha V^-eg to beAranflftirferi to^B 
A-rtg, 

A-EWG HDDS - Tht A-r#g ic scmetiines called the Accumulatar'- Thi4 it a 
cftrry over from mere primitive timeSi In any flventr CcmmodDre ar»d HO? 
Te^hnclogy chcxjs* to re-fer to the A-reg Mode as the Acajmulator Mode. 
Call it vhat you IiKb, it is raally an irriplied mode. In A-rtq Mcfle, 
only t^e A-reg and the Ca-rry, Negative and Ziro bits Of tfi# Statui 
rsgiBter are af^cted. The A-reg -mode instnjctiDnfi are valid only -Fur 
the "Bhifr InstfUCtJorw, ASL» ROL, LSR and ROB. For more irWopmation 
□n ihi^ initnictiarnt -an tfic rrtnl chiptrr. SxamplH: 

»21A SA 

A^A 
R21S eA 

RELATIVE HDDS - There are thrse dassea of ins^tiana which CkiM 
the tlQw oi IhH frogram to chingt- n^e JHP and JSR instPuctiooB are 
enplained in ttit following chapter. Ail three types of inst^tions 
accDTnplishpPogranflowchangeEintheHmegtnfl-ralway. Thty cauit 
tha PrograiBCourrtef rfgi«1tP tQt>i mDili+i»4. The PGi» re^^ter 
pair which point* Id w4wrt tha nut insirtEticn ii to be ffu4 ih 
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memory. It \5 automatically incremertted Qy the irkstrjction Length 
path time an instruction 15 tiiecyteO* ThE instruttions which maflity 
thp PC cauce the program to "^tike a brandi", That is, th# nei.t 
inatnictLon to be i>iecuted will rot be the one ioinBdiatsly following. 
It will be fvxid at an uldrffEs whi^ is dittrmifwd by tht iddrpssing 
d*ta ftuppleii.b^ the branching instnictlDn. 

^e add<^Uirig ^^ifdnna-Hcin supplied by the '^relative mod^*' 
instructions is a ^ngle byte o* data which follows the op-code and 
which IS added to the value of the PC to determine the new PC value. 
The brandi ^s ta an adOr^e-s which le tiie specHud nujnber oi bytes 
away -Froin the brarKh instruction ItseH. The address lofortia'tian is 
[;an«d the relative displacement. 

These instructtors only modify the PC tomc-fimps. They are 
cal]«d conditional branch instructions. They test the status o-f a bit 
in the ProcESSor Status Register and the iTift2 decides at the tame the 
mstpijction IS Biflcuted whether to Branth 1 moflify The PC 3 or not, 
baaab upon the valua of the bit being tested, Exsmple- 



CMP M'A eaae C9 4i 

SHE NGTA 3362 93 

JMP PROCESS*! 6385 -IC 7D 64 

NOTft ChP •'B 8388 C? A2 

BEQ PI^DCESGB eSSA Ffl CC 



This IS a short progra in ^egi^ent which first compares the 
contents of the A-reg with thi diaracter "A". The format of the 
pTDgriiH listing is the same as that stluch is produced by Tha AaMfffibler 
whan printer output is employed. Not* the- iimnadlBta Bynlidlf "9° and 
tht 'character" synbol " '"i The ^nciionof tfn conipan inslriJctlDn. 
is to let the Zero bit in the atatus register if tiffi mniHra tFOVea to 
be a match. Otherwise the Zero bit is cleared. 

The uistructiori after the compare is the conPitianal br^h 
snstruction.. It is a Branch Not Equal instruction. If the result of 
the CQinpare results in the zero flag being set, the branch will not 
happen and the JKP instruction folkosving the BNS will be FKecLfted nent 

usual. -If notp the ntfxt instruction to tia evecuted ^all be "the 
inslFUEtion at l03flS. 

Hare joo set one of the grett idvftirf^geS of having an 
aasei^Ur whkh. allows you ia use Ubets Xa identify prograni 
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iDcatiDta^ YoUf the progrdmrnBr cm u«b fTEarangfqjl ^ymbDlfi tD rtfer in 
some address in marriDry. Ycu «vnf« thf d^^rmbly Unguigt program 
i^/ilhDut regard to th* actual adftr^sse^ erf each instruction in the 
prDgran. U you want to th* program io brdnch tc fiomF 

imtructiDn aomewhtrc In thff progrunt youput ailibfl ^Snglish on 

of -UW inGVudiusn foryixJ, In-lMftcantt* Hy-mbolic labal U 
■NOTA". 

Aa»mbler5 wt^ich permit thia cipa.biliiy are callad fiymbolic 
usftnblprs. Single-Lne issemblen such &s is mcappnritid tn VICHON 
Art uverBly liiriitEd by their lack of this leituTA. 

The generated machine idngmge is particularly interesting 

htn. Tti« byte +DllDwing the BNE □r>-coac \z i 'tes". T?EUt3,ve 
addressalng mean^ ti^^t the valua tound in the byte after t^a op-code 
is the number to be added to the PC to find the address to be Branchid 
to. Thatisi if thf6Se2 finastn-at the stdtUiS bit being tested by 
th* Brtneh iretruction indiutti a &anch shuild be tti^n, H ifmi 
adds vbIue fou^ fn Vt\» byfe aftvr lha Dp-^odH tO tiw n!. Itt h» 
ilTfii^y irnrsmpnied tbp PC by two before testing the status bit). The 
Asurrbler autotnatically compute-s l^c differsnce between iht address of 
th* instructiorr foUowing the BNE instruction and the beginning erf the 
instfLictian KDTA. In this case the amsunt of idjjstmeiil is three 
bytes. NOTA occurs three bytps past ths iddress of the JMP 
Instnjftian. It ib po^^iblw to ^ftf/ i fflnditional branch forwvd 
by as much as 127 bytes or -backwards as much as 128 bytes. "When 
baclMard branches are specified^ the displacement valm.in the byts 
a*tep th* Of^codff nusl contain a negative number. 

Vt meniionvd varlie r that a single byte flay repcfunf ' the 
dednMl range of A-^SS. For spedal ^tuations uxtt u the relative 
brtnch InstructiDnB it isConylenltnt tn illow th* 256 poiublt vtluim 
of the eight bits. to represmt a range of numbers -from -128 to *127. 
To occcmod ate this needt a Byitem was devised to indicate neg-ative 
numlwrVi it is tailed the two's tompleinent systeiDi It set a littlt 
strange at firstt but with a little practice itt too. can be mastered. 

Kegativi om is rE-prcsinted at IFF. HeQ^itiVB two ia 
reprteentid u tFE Cor 254 in regular decimal ). You can convtrt a 
number ta it4 rag«tlv» bf subtractingi it from 25£ thtn converting the 
result to hfiT, FwExiKiplit th» hm Pflppf wntition 0* i« Z34- 
d>25«MFA. ThjesyBteHiipopjUrwfthconfiiJteritosigntrftbKaUuit 
n^Bvitfimctk-eaey. Note tfiat 254 in heit £■ MlM. Si^trirte^ 
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siK +rain iftlftfl qive^ ITA, But IfiiSS take^ two byt^s. The ina>iimuiii 
value of or» bytp 15 *FF, If we add one to tFF we get Iflft with a 
carry of one. And with tFF representing -I it is very riice that when 
we add L to-i ve get Likewiee when we add 1 toninui ( IFE > w« 
g«t tFr t-L). AnothBT adviMagfl of thii Hyttim ifithat tU Iht 
negative rMabfPS have the hi^-ord^ bit on I leftmost bit vtLuv » 
11. Thepo«tiMnMberCiremi0»flU««)tol7F(411itilll 
and the negative runbers ore m ( llflS HOfl ) to %tP ( iUi itJU. 
rit is cDt CDincjdentBl t^t the N-flag ^Negattve bit the Status 
Pcgifiter) ie ut ivery tima any arlthrrtetic DperitiDnr«eLilts tn a 
value with the high-order bit on. 

The Assembler will automatically convert relative branch 
diipIacEiPEnti to the proper value for both forward and bacKward 
branches. And The Assembler will also allow the eii:pres«ic]n of 
negative numbers in the more familiar format of decimal numbers ( -34r 
-\2Zt etc. 1 and do the convtrfiion to th« two's complffftnl valLie for 
yoLT. JnilitHjggingthawevKi it Ej»B*tiiMH earner in lundy to txablt to 
do the cdnverJlion yot^self and is worth knowing how to do. 



IHDBISD HDDB5 - The ]C recrister and the Y register an sometimes caUed 
the indeK registers. This is because they are used as inde:<es to- 
data. Tiiit is, the relative position of data in a string may be 
addressed by specifying a base or starting addr«as of the string plus 
Eoma pE>sitiDninde>: to indicate whidi data element in the string Is 
being addressed. The X and ¥ registers can be used with certain 
instructiHK to be the position vide^;. The instruction specifies a 
base addreas and an index rtgiEter. The 6'5%2 adds, the value of the 
index riveter ta the base address to grt ^ effective address of the 
data to accamdi TTiifli»a very useful capability. Thefollouuig 
prt>arim THrgmnt ilkatratts tho uh of indexed adikvHing Id maw a 
strfnQ of data fron one place in menory to another: 



STRING1 EQU 16406 
STRINGS EQU ^9498 

LDX itia 

LOOP LDA STRINGI ,X 
STA STR]NG2,X 
DEX. 



6480 

2662 GD ee 84 
2805 90 80 SI 
20 CA 

2ier 10 F7 



Sev^il ntw prnerrtBd »n Wis progr«m Mgnentr Tb* 

fti^ lyast4l>™ntsciiJM The AiMflibler^DBc^jale ft aynbolic 1ab«] 
wrth*«ptC«ietddP«Bini»iWrv. For tvfc^y aubsequtni rsfsrsncE to 
the libt-llwSngBQUitBd OTHlKGlinihiKBifimploI Th^ As&intiiBP will 
»ffww that the addrBBs bs^ng pBfaprecUD is th» in tt* Durmd 
fitld of thF EQUfitat»n«n-tl>840U. Note th» BBnnvtfd nAdiiW 

targuage which foUowfi Wfl sia-tein»nt; LOOP LBA.,STWNGiA 
address is aLriOI^fttically generfttnd liy AMmblef- <in the 

requirtd lowordep-Erytc -first format ). 

TJie third EQUite tells The Asseinbler what valut to assign to ths 
Location Coimt«r. The Locatinn Counter is The Assfim Bier's BqUvilent 
of the 65(2-'sProgr4m Counter. Thf fliftsrsnw is that the ft^gram 
Ctwnter ia an actual hardware register contained on the 6592 -chifr. 
The Lnci^idin CpintfrwT^ie Agiemhler's ay mboiic equivalent of the PC. 
The addreas prirrted on *hB mattiiw linguage line after Bdth afiumbly 
iitstructinn is the value of the Locattcn Cihjrrter fijr vach instructiDn- 
It shows us tt/here ths gereritedma*irttf languag*VillbB in nemury 
when The Loader finally loads the program intn memor^. Every BQEIttt 
a-tatement sets Itie Location Coijnter to the afldresa exprewd in the 
Gporand field ot -the statement. 

The LDJ; instnxtion loads the X-rsg with thie value If. The 
next two instriKtiun-B illustrate the inda>:ad addreasing mode. The 
iinX instruction loads ttw A-rtg with t byte of dati tound it address 
tWft* The addrosEfiOecified in We LDA instruction is WM, The 
ConlanH O^theJh^BireiddRdtotfwipecHiedaddTKBbyihe iSM 
beffire puttinjthe aifdre^ dn^e arfdrefiH tUS. Snctthiil-rtg has 
jLHt been loaded with the value II, -the aridrBM .(ifhere the data will 
mme from tfl he loaded into ^e A-reg is IftMfl * UUA or **4ftA, 

The next irrelruction turns Tight arajnf and stoPBt that same 
data bacH in memory at the address IflftSA- So we now have three copies 
of the 5acns byti oi data. One fopy in WflA, on* in mBfi. and one in 
the A-req. The rt^y.X instrLCtior, LEXt causes the X-reg to be 
Decreased or decremented by 1. Since it had the value oi Ift coming 
into this iratructioTi after the instrjctian is s<ecutBd,it will have 
the value off. The next instructior, BPL LOOP, will conditionally 
hr*n* to-lhtinfftriiclionvAiiJih^sttwl^^ Note this ia a 

b»0(yf»rdl>panchDf?fiyti!», The gnwritid macMm Itngu^B vajui of 
how far to br^Kh is Remenber thaut ntgative branch 

AiapUcttnante? 25*'?-247. 247 / id ' iS with anHindvcrfA 
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Hence the hex value of -9 - t?7. Convienientlyp The Assecnbler made 
^t caUulation for ui* 

The BPL instruction tests the Negative bit of -the Status 
Register. BPL stands for Erand^if PLuft., TTie VQativt bit i« 
affBcteti by Ewry r^ecutionof tDfiXira^^tion land BMrtf nthtp 
imiructiona a« well h If^ )^g wac nm bafdn ^ eMKUiion orf 
the DBX «erCBul1crftheDEXwni]dbe&rtegitiv*KJAberin1he X- 
reg. TTie Negative bit would be set to one. The BPL tests the 
negative bit, H it is not d one (rtot negative) the X'-reg mg^t still 
bB positive or ^cro dfter having been decpemented by the DEX, 

The branch will be taken bacK up to LOOP, The A-rey will now 
be loaded from address 1^409 and stored into address ^0489, The X-reg 
li^ill be de:reinented again and tested to ue if it vent mgativt yet. 
QncE againi it is positive t ii has the value & now X. The branch 
will be taKen back up to LOOPi the same process will occur once againp 
this tint noviog a bytv from 16409 to 10438. Once againi the X-rvg 
sidll be dKPenented and testtd and found nct-mtgatlve. The \aop will 
be executed i totil i»f 1 1 tines, vdth the X-wg varying from to 9t 
the «^0dmf- Df d«tA beii^ Indrd into the A-reg vu7ing from lt4IA. to 
104401 the address of where data is flioved to varying froni ftMSA to 

This is the pnxes5 by which a wide variety o* repetitive 
operations ar« performed lipon data with the &362. This is a very 
standard loop, [f it still steniE nyBtprtouc to you rmA li aver again 
and when we get to the section on actually using T^e Assembleri The 
Editor, The Loader, The Monitor > and The Decoder, we will create an 
actual program stfhich doea juet thiiprDciH. ^e will exacute tha 
progru one stofiazt a tise with The Konltfrr watdr^tiow tvvr^thing 
wortlEand uelng the registtrv and the nenory loc&tions changing u we 
go through Iht program. 

There are four modes of addressing which are mikd '-^eited. 
Both the x-nq and th| y-pfg inay be used in inde^^ad initnxtiflns and 
both nay be used in combination with ^soulte and Zera Page modes. 
Like thr absolute and ZP addressing modesi the absolute and IP.X 
instructionB taWe three and two bytes respectively. Tha Y-reg and the 
X-reg function identically in their respective modeSa The -hu' 
indexHl modes IhH iret ab5rX ; IPrX ; aba.V ; ZP,Y. 

mmCT XCn -ItwreiaonlyfninttmctiflOwhkhuuittH simple 
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indinct modf bt idbressing. This is tfw JMP Uddr) uiK^xctiorv Thv 
pirmtheiis arDu-id ihs Atasoliitv uUr<U Hlflnifi«s andirvct. ^Jh§.i 
hftpptra With thi indirect ijnp ii tha foHcuii^i l| fha dSK gftta in 
MJdmKfrontht two bytffsivnwdii^ly follbwing^U op-oodB. Rather 

than loid thp PC with this valufi dirftctlyp it fstche^ an iddresi 4roiD 
ihe ^crfipd rrreirary iKJtior and tht Ttitmory iDCition ifflnediiiily 
follcwing it. This is the address which it loads into ttiE PC. Thus- a 
chdfiga in the pragriin f]aw i« CAu^ed. 

Tq Btits ihj^ ^tripf vjay, -for "til? JKP indirect tD hdtK ks 
de sired r ihvrt nrust be an address pre-stared Eom4wh«rp in memory. The 
JHF inctTLictiai must icil the £532 where thai address is louied in 
Wemori'* 45*2 will then load il* PCvrflT) tfi* frdtjrsit Stand 
ttmraltn. Such a prntcml addrsEB i« olljpd > vurtor^. BAQlC hHk 
uwtl ^ctori MVid In lh« iirsl f«wcu|]»s nf niCfi^ wtuch point tci 
viricuv processing programs- 
Vectors are convienient ways allowing thB flairlbla design 
□1 cpirating cyetsms Euch that new verfiions and updati» la the 
Dperating system can be i:Dmpatib1? wiih the old versions. PrDgranifi 
whiich need 1o use the vAri-cms rDutin?^ pointed to by vpctors will not 

need to be ^hdn^rd brcdJK of a difftrEnt loDdtionof trie routins In 
thE new version. The vector viii tie thi only thing wUIhavK to 
bi iiKidifiid to allow compatibility. 

aHDnWCHiY -This mode is somewhat similar to the induct iTKidB 

ihdtrtietiqn> This mude is applicable to vtr^cus dats access tnd 
nanipLiUtion instructions. These instructions arc two byte 
InBtrueliorB. The ^ecnnd hyte cf the mBtmrtion spenfiee an addreu 
in nrc page- Like with the previous ntodB^ there must be an address 
stored at the specified location. The big difference here is that th? 
Y-rsg it added to t^ie &ddr?£s foind in ?»rD p^g^ to give the ASeZ the 
eusntiiai address of where the data should com* -From or go to. 
The Qndir)>Y node is actually used e>iactl>> hks the addriY mode- ]t 
UMful for ilEiirg loopG. The only E3iffiren« is thi base 
address <H the loop is stand in Zef^ Page rather than spMltivd 
diJ-Ktiy b> th* instruction, Tt« Irartrttftinolhin aptcities thfi 2ern 
Page locatlDn pf Ihl b«M ■difrtM, Thiflrtavery handy way to 
program a subroutine which is used at different tiinas and callpd Irom 
di-Fferent places in the nainlirw progran to do the ^ame gsndral tasU 
but wktn differing sets of data. The base address of ffie data to be 
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manipulated by the siiiroutine must be appropriately set up in 2ero 
Pag* each time just be'or» thi ^routirvs callpd. Tha cubrartine 
itsfllf never has to change anything- It uses the uro page vector to 
{prt the data it's been called ia use. flxanple^ 

SUBRA LDY 

LOOPA LOA <47C),Y 

STfl **afli,Y 

DEt 

BPL LODPA 
fiTS 

Kerei the iiiiroLrtinei SUBRA. is dcsi^fwd to do a general 
purptrar fVf 0*ta from some locAtionirt memory to some other 
location. The nuralier cf bytes to tie moved is found in location »8fl4ft. 
The locatloTi of whppt to move the data from is fcund in I087C ktxI 
I447D. The address ofwhere to move it to is found in locatioris 

and (4081. The calling program must set those locations ifi with 
tha ipprairiiti vtluii for the subroutine to function as dasirad. 
Note -Hut no left arrow is required for the CindeKedi^fY nodt avvn 
thojgh tta ap«clfl«d address is alw^s in ZeroP^c. 

aHDIRflCTJO - This is the last and probably the least useful 
addrrs^nQ mode provided wllti the ^42. You may have guessed that It 
is similir ta the prtvioua modei It would be a lot mo-i uHful if it 
were identical except for the register used. Unfortunate tyi it isn't. 
You ^oi4d notice that the X is ineide the parenthesis* whereas in the 
previM -niodrr ttlt ¥ i* OLrtSidP the partnthflsis- This i« the 
important distinction. The parenthesis imllcate the "uuliractiorf'. 
In the priviDUft ixupltf the Y-ng was added to the addreii ftuid in 
Zero Pagep and the rewlt of that addition frovided the address of Vtym 
drsHTd data< Karti the X-rag is added to ^.sped^^ address to 
4MwWffinZeraFagetiHvflttDrr*ftidia. Th* X-ng ll 1hiP«ftn tn 
inden to « tatile of vectors stand In 2erD Page. This mode Is net 
usefuLi there f ont in the same way that the other one is. It night 

umr UH in unuiml lituitiim where therr n a nerd ia han a 
list ai addnssis of data bytes and a routine is needed to process the 
various data bytes. Such a routina would ste^ through tl-ie listi an 
address <1wq bytc&l 4t 4 tlnei Ming the X^g to bump thru the Liat 
and to point to the appropriate address at whidi the data will 
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ultiflA^ly b» found. Ptr^ip» you can find srant batttruu of this 
modt. 

Th»u li%X fajT ch^pterc have bftfln fairly pacHid with LnfopmatlEvn 
on the worlarsgs of the fi5ft2. It wiU be necsssary to write some 
pTDgrims and tc fi-HimiriG the programs of ath^r^ ta gal a fom^Dri^ble 
fHling tboA V\t uh of thi various irn-trJctions ^nd iddrvt^toj] 
model. The ntHt chapter wll pr««nt every avaUab^ ifwtruction on 

&S9t. After nnnplttij^rt, yuu srillbe ahl» to Bt*f^ to -ttte 
tofUroi 0* four coapOtir by wntmg powirful wthinr Imgutj^f 



ASea — InB-tr-ue^lDi-i 8«t 

There are 56 9epi.rdte instructicns which the 4542 hie been 
dHigrwd to pvecutp. Ti«re an ilso two "pciodo-ap inairuciiana" 
which are noX a pari of 1h« fnsiructiDn set but whith The 

AEUtnblv unlerstands. 

Ther«ftr« Uiddrtsi^ncxitL 6om initruEtiDra if« Unitfd 

to a lingle Addressing ntNtot DtfHfB » capiblc of util^Ttfl t«3 to 
dgh't. H«t nHhei^tructisrnarBE^te slAFde func^onaUyr tnd 
nqthn ordy a Bfftiterm v Iwo Id i^-icribt tttiir chflrtctsristlc^ Vt 
vfiW cover tHeee -fir^-t. 

Rigiittr-flnly irwtructlani 

TAX -Tranafer the contents tj4 the A-rtu (o the K-Pe^g. Ofily the 
receiving rpgifiter i« maQitied. The Zero bit of the StatLrs Pegister 
is set Imade to h^ve thq vaiuB Li if value transterred ^ercip 
ErtherwiK i-t isclvirad^niAde tohtvffVu value 0). ThB Ntgittyi tut 
of t«e PraauDT S1«tui Register Is set H ttio high-ordir bttot ^ 
valu* trane+errritlB-jDn (value I), vise it is dearedi 

TAT - TriTWter A-reg to Y-reg- The A-rtQ is ttored into -the Y-reg. 
The W(W notes apply at with TAX. 

TTA - Trana-Fer Y-reg to A-reg. The ir-™| iB Etored iilta the A-r«g. 
The fiairiB rutea papply as- with TAV. 

T3£A - Transfer X-reg to A-reg. Tfie X-reg is stoTHd into the A-reg. 
The «am» ngM^ *Pply « wi*h TAX. 

Tffl-TransferlC-peilto-BUdJPpifW. Tht X-rdfl uirtcrtdTnto »» 
et«rV Pointf r. No G-tilui tills irt iffecled. This IfllhMfily wiyof 

initi alizinn the Stark Pointer. 

TBI ' Tnrftfer StarM Pointer to X-rvg. Th* Stftdt PDirrtir ii itorsd 
into-ftt X-r»g- The uh nolH apply as with TAX. 



nC-SBtthiCurybit. Th« Cury bit tc wt to vtlur 1 



CLC - Clear the Carr^ bit. Til* Carry bit is detred, 

nil - BE-t the DflEimil Mods bit. The Dvciiul Hod* bit is wt io vtlum 



CU3 - CLav the DffcMl Hodv bit< 

bit is dBiml. 



Ttw DiciBAl mode of opmriWsn u 



CUf -rCUaP DVepftowbil. ThuMJpflowbitin tht FromW 
Rrgiitir iscluTHl. 

CU - CLtif ifit Interrupt diublB bil- Ttit Intern^ii diublc bit in 
the Processor StatuE RBgLftt«r is dearcdi allowing iriternv^i to 

□CCLT- 

91 - EBt tfrt Intern^ Diublt bit. The Irrlerrupt disable bii in Ihi 
Processor Stetua re^iBtaf ifi set to 1 , causing all intenuoti to be 
mdsMffd EdiHblKtJ mti! IN Intarrupt dlHbli bit iv cltirvd wm i 
CU. 

DBX - Mcrement the X-reg- Th* value corrtfliatd in tht X-rtj i* 

dacreased by 1. I* the resulting vilue in the X-rag is isrc, tlw Zero 
bit is 3ft in the P. I* it is not zero- Vie aero bit is cleared. If 
the resulting value in the X-tej ha& the ^igh-p^er bii on, tha 
Negative bit in the Processor Status ^^egt^ler is set, Olherwise Vnt 

Ha^ative til will ht diarecl. Kot* Ihit regislfr viIube ot ft-J27 will 
havi adaarhigh-ordEfbit end valuaaDf l2S-Z5t5 willhave the bit 
»t. 

DBY - DEcrement Iba T^g, The value nf the Y-reg is (tecraaBed by 1. 
The Zero and Negative Ijtts are iffscted as with the DHX instruction. 

IHX - INcreivent ^ E-rtQ. The valua of the X-reg ia increased by i. 
The Zero and Negative \a\i are affected as with the CSx^truct^. 

IHY - Increment the Y-reg. The value of the ¥-reg is increised by I . 
The Zero an iJegaiive bits are effected as with -the DEX instruction. 
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HiBory aimaing inatPuctioni 



INC -INCremant memory. TTie value of a byte located in inemory is 
LHcrsAHd by 1. Ttit Zero uid Nvg-itivt bits an if^cted *F with thf 
DGX instrt£tior>. Drdy Wi IPX ABSi AfiBJt modes are v^. 

SIC - ttC^TBimit lUflWHT' the viim a by^te located in ntfliory is 
dtcr*«9Mby 1. The um cDftiraentB *« apply for INC. 

LDA - LoaD the A-reg. The contents a memory lacation is 
trinsferred Id the A-reg. The Zero and Negative Bits are atfectifl as 
with the TAX irffiTmcTiDn. Vilid idbreasirig modes ars: Imn*diate: IP; 
IP.X; AbEolute: AbaolutCfX; AbsD}irte,¥; nndirectpO; andirect,r> 

LD3[ - LoiD the )[-r*Qj Thi can-ttnts of a mcniory loc*tlon ii tpansfiftd 
to the l-T-eg, The Uro and Kegative bits ^ a*^ted h vith the TAX 
instrudion. Abs. IP and iPiT addressing nodtfs are valid. 

UJy - LDaI> the Y-reg. The contenls o-f a memory location is 
transferred to the Y-reQ' Tha Zaro and Hagative bits ire affected as 
with the TAX instructiDn. Absi ZP and ZPiXaddrassing modes ire 

valid. 

STA - STore the A-reg^ The contents of the A^reg is transferred to a 
memory location. No registers or status bits are affected. Valid 
iddresiing moda^ are: ZP; ZPpI; Abiclute; AbsoluierX; AbraluteiY; 
OfidirectrSQ-^ OniUrrciiY) 

ffTX-STorflthc X-rtgj ThacortBrrti of th« X-i^ aral^mfirrh] ta a 
memory location. Nd stelus bits or registers aPe a-F(«ieif. Absr IP 

and ZPhY addressing modes are valid. 

BTY - STore the V-reg. The contents o+ the Y-reg are transferred to a 
memory location. No status bits or registers ara affacitd. Ablf ZP 
and ZP«X addressing nodes ore valid. 
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Conditiaml Srancti Im-tructiorm 



BCC-Eranch Carry Cl»dr. Th» fvitgriiin cnjnitr m11 be noditi»d hy Vw 
-mrat^^t cjt "the speci*iB-d dl-splicenwrrt M.indEnljr i^th? C*rry bil is 
Clear Forward branchsB may occaff LffJ +n JZ3 tty^es frnm 
aB(*r#5fi Of Ihfl ?irttbvtfl*Dilawmg th* Oraftch inetruetion. Bid^ard 
brinchea miy inccur up to 127 bytn^from ^he stttm addTftctt. Ua other 
rvgisters other -than the ?C are affvctvd. Onlr Ftelativa adiir^psaihg 
mode ]^ valid. 

ECS - Brirxh drry Stt. The program counter will be incjdLfie6 by the 

jmciUHT of Ihe sosnfitd di^piactrrent it and anly H the Cairy Oit n 

5^t (II. SdniE LommPrrts as for the BCC inslrucluin, 

BH& -fifirch EQUi. Thr prD^ram cwfitfr will be mDdi^ffd by the 
amouit of the -tpBci^ltd displaunvnt M And only if thD ZBro bit is 

BHB - Brdrch Mot Equal, Tht prngram [□unter witi be modifipd by the 
amount the spsci^jed Oispls^eitient j.* and only H the Zero bit is 
clesir (fr>. Same CDmnents as for t^c BCC imtructlan. 

BHI - Branch Hlnusr Thi prDgra.m countpr mil modi-fied by tlw 
amount of the specified dxspla-cencnt it and only li ttw Minut bil IB 
est tlK SafW ccanflents *i ihp insVucfaon- 

BPL - Branch Plus. The program countir ^ill be mcxJif £id by ^ UUunt 
oi the specified di«plb:ement 3^ and only if thv HitnA bit ii tltfir 
Same commentB as for "the ECC instruction, 

BVC - Brawh overflow Claar. The program counter will bw modifiied ty 

the a^omt of the ^cified displace in ertt if and only it thE Dyerflow 
bit is clear (9), Sane camments as ior ihe BCC instructian. 

B>A ' &anch oVirflDW Bet. The program ccwttr wtll bi modified br 
the *ii(mt£rf flw-BpecJtie.ddi^Kewnti* indordyi^tiw Owerauw 
bit Uutlt}. SanamfnniFnteaiMrtiMBCCvi^^'uctiDn. 
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JuBfi inalriJttloni 

JHP - JuHP. The PC is loaded with the specified adbr«s4i causing a 
change in the flow of the program. Both Absolute and iTxhrect 
addrc3una nodas ar« valid. 

Ktt - Jump io'SubRoufine. Thff PC is fif«t inertnenttd by 7. The h«w 
PC Jfi then storedon the itacK, The PCH is stored in the stack 
locallon addreEced by the StacK Pointer. The Stack Pointer is 
dtcrrmented and th« PCI i« thin stored in the new etack location aa 

addresied by the SP. The SP is decrecrenteb a second tiine and the 
dddre» specitiid by the JSR instruction is loaded into the PCp 
cubing a jjnp to thp cpeci-litd tufiPDUtine localicn. Nclx that the 

address stored on the stairX iS not what rriLght be expected. The 
address is o^ the third byte of the J5R inetmctiDn, tint the afldres* 
□t tht ni:<t Hquintial instruction itter the JSR. The RTS 
inetnjctioni tMvts cuhh a rehm -frran tte jHiirautine r compensates 
for this anoniiy. tjtf^trallT. catual progr Aiemw neeiln't m^rr^ 
flboyt thp niethamca O* *t4ttf cp*r*.tiDni aa long as chft always has a 
RTS ior every JGR. Howeverp advanced iniEhine language progremmers ere 
4Dnd of direct %ii6l manipuletiDn technic^st espcbally passmfp 
arguments to stibrautinH. 

PTB - BeTiirn frnm Subrmtini. TTse Stack Pointer i5 +ir£l incrsiTiPntPd. 
The PCL is loaded from the stack address pointed to lay the Btack 
Pointer. The SP is then increnwnteil agun end ^e PCH is luderd from 
thff stack. Thi PC is incnntntvd to romptniatt ffr tht JSH optration 
of putting tt* «ddreta of «>t tMrd byte irf ^ J91 on the «t«cK 
inatttad of the iddr«s« of the iltxt inatruetitirb. htwlMF>Chat the 
addPffn of the initruftion immtitiittly fDUming the most n»nt J5R 
irKtnjtrtion. The prograin flow i» ttu« rettmed tfl tt>« mainline 
program front the subroutine. 

BTl - SeTum from interrupt. This instruction reverse-^ the process 
wtMCti cccuTB when an intsprupt occurs. Ths PrKessor Status Rsgitter 
is retrieved from the stack where the interrupt caused it to be 
stored* The PCH and PCL are then reloaded troiii the stack where they 
too vMTt itond IB a.pvt of ttiidSU's irvtiffupt pnicHung. Tht 
retWTv tfte poiniof intemjplion is ttius HiBpt«tet with the 
PrdcaHdr ^tus RegtsliF havinti th* Mut- Value it had it the tine of 
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inttrrupt™* 

BRK-BR»K. IrrtifTUptprocBaKngi^ciiiHaO to occur. The dddrtM of 
the nsxt bylff followirg tt» BRK irwtrurtian Baved on ths stick, 
■me Breik bit tur«6 cjn in PfGCiisor EtatiH BtgiBtep wtucti 1b 
then HVPtf on IhP *ta:K. Thr PC ie iMtrtd with tht HidreiB fotfid at 
meaGTV iDCition *FFFE *nJ »FFFF. 



BtMR Piah t Ml iMtnEtlflrw 

PHA- PufiHthe A-rig. -nit A-ras « stareiJ a»i the nticK at irw addrMt 
pointtd to by the SP. The SP ii th^n iJf cremirrted, AU PHA'» should 
gonepaUy be matched witu i falliMing plA, 

PLA - Pult the A-rea- The EP n inCPftrHfrttd, theft tf* A-refl is loaded 
fro* the itiftlDCition paired tuhy iJje new v»l«(rf«»SP. 

PHP -PusHthsP-rea- ThePro«iiOP&titU5rtgi»trr.wpufit»d onto 
the itacK in the hihb fiahlon the A-reg is with the PHA, 

PLP - PiiL Ave P-rea- TtiB PracniOP Status register in pMilw* 
the rticK in the uiH *ashim ^ A-refl is with the PLA met^JCliDn. 



HYT Thi? is not realty an instructipr in the instruction ^el oJ 1*e 
65ft2, It It an inatructlon which The Asiefffiiar recogmzM »nd 

interprets to mesn generate machi«lanBuafl»lll1*- 

Erf the EYTi™truCtlDn«neitpreMWvertltypeeof data wtudv The 

Asaenbler will underatWl. 

H tt.firttchu'icterrfttrtFfTisa-*-. the following 
Chiractersmiatbehe. characters, l-e.*-5tA-F. The Aa«n bier -ill 
ftindle ■ string hen characlBrt up to 8« characters in J^; 
viU «neP4te a data string with twofiybblesti half byt^ -4^t^ 
per byta, insarting a *a in t^ie high-order nybbie o< the high-ortfm- 
byte 1^ there ar* an Ddd number of charactera specified. 

H the tirst c^aPicter is a " % The A«einbl-r ^ . 

data atr^ with afi miny byl« as there are chiU'artets ftdlo^ tf» - 
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The v«luet of the generated bytes will be the ASCII values of the 
iflTfespondina rharacters. 

1+ the -first diaracter ti^e opef-and is a nunber in the range 
■9-9 r The Aasernbier will inteiv'vt the Dperand ai a decimal number and 
convert ;t ta itE binery equivalent. 

If 4irEt character is nane ai the abovei the operartd will 
be aaeumed to be an Address eKpression which represents a two-byte 
Address, It M^lmmpufe the addritsasudaled witti ttw Mprraicin 
and generate the etindarit Idwonier first fureiaT tw6-byfe a<ldr«n. 
Ad(fr«s« eitp»s«ionfl are covered fully in the chapter on writing 
assembly Itngusge tirogrnns. 

BQU - EQUate. Tfiis pseudo-op doee not generate any data wbich gets 
stored into meinory by The Loader. It is an instruction to The 
As^mbl^r -ta set the Location Counter and to cause the label in the 

label field lode aestgned to the iddresfi which is expressed in t}>t 
operand field. 



Shift Inrtizttom 



ASL - AnthiTiEtic Shift Lsft. The contents erf the A-rtg or of a memory 
location are shifted one bit oositiofi to the left. The low-order bit 
position is -Forced to value zero. The high-order bit is shifted intp 
the Carry bit. The Negative hit is set if the bit shitted into the 
high-ordir bit positive IB a 1. ItisdeereQ i.f it is a ze re. The 
Zero Iritis set if th^rcBultang value ot the stjiftftd^tf- is wra, 
Eleved H it is not. 

Ad Bno:(afliplei if IHeA-t^ has the value ICC (ll.Hlie0), 
after thfl "ASL A" inatmctionfias teen eKecutedj itwiUhav« the 
value I9« ( 1691 im ) and the carry bit wiU be eet. If the A-r*g 
has the value of »5F lavft] 1111 ) the "A61-A'' will cause it ta become 
aBB Mflll ni0 ) anb the carry bit will be clear. Note t^$t each left 
shif4 causes the A-reg to double in value as long as the high order 

\ft I cne before ttie sh:ft. Shifting left is a convienient way 
□f mirltiplying a value by two. Using ASL in E^DmbinatiDn with ROLf a 
multiple precision ^ft may be effected. See the desiTLptkm of the 
ROL instmctitin^ Valid addrcsiang modea are: Aaumi^ftrvi -, [PtK i 
ABS f ABEiX. 



HOL - HOtfltfr LpK. The A-r-eg or a byt* in memory may b« 5hi*tEd ono 
bit to Th& IpH. Th( high-ordflf bit gei* *hiHed into ihs Carr^ hit, 
Tfie knw-Drder bit recieves the previous- cantents of ihe Carry hit. 
Thfl same aJdre^^:i-,Q modes ipply as for the A£L irrfitruct:on. 

A multipis precision bit ^hift □n? wher« a string of bytes 

ifl tr^atta liKe cxie long bit pattern and 1hE Bftift cauMt the bi-ts 
wtiich CDms Dut of the high-arder pQiitiars of one byte got ^i-Fted 
into th» low-orticr poHton oi th» next byt* in the svquencB. Fop 



LDY #3 SHIFT 4 BJTS 

BITSU LDX 114 THRU 5 BYTES 

AQl STR,X RIBKT-HOST BYTE 

DEX 

RQLIT ROL STR.X 

BPL RGLiT ftu erres ? 

BPL BITSH HLL BITS ? 



This routint WLJulfl cauBe the string of -Jive bytts at STH tn bf 
l**t shi-flBd tour bits. Each execution of ths ROL shifts the contents 
of the Carry bit into the low order hit 0^ the byte h-eing shifted. 
The C*rry bit will crxitam the bit Which wis ^ittefl out of the high- 
order btt Domitinn of the previous b/te. The ASL \5 used -as the -first 

Bhift instruction to -force iero bits into the low order positions of 
ftt iQw-rv^tr bytes. 

Lgfi - togiuL Bflift Rigftt, Tht conlEnla of the A-reg gr iherfipry 
iotation sp«i^jeiJ is ahitted ono bit poHtiPnlottiE rijht- The low- 
ordar bit gets shifted into the CaiTy bit- The hiB^>-orde'' bit 
position it forwd to itro, Thr Ispohitifi Hf ttiind upon the 
Pf suiting value 0+ the shifted by*e. The Wegative bit is forced to 
zffro. The siine aEJdre-ssing model Wply ts fcH* the ASL instruction. 

ROR - Rotate Right, All bits in the rotated byte are shHted one bit 
position to the right. The Carry bit is shifted into the high-order 
bi-t position and the low-order bit position is shifted into the Carry 
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bit, Tlie SAiiiB addrsssing modes apply as fcr the ASL instruction. The 
LSR ind flOP instructions are the sdtnt as The ASL and ROL instructiors 
except they thift bits in the oagosite aireciiom^. Note that i am- 
bit shi*t nqht results in an effactive division by two. 



BDcdein iPifiiHts instnztiivis 



MtO - Logical AMD. the A-rtg is logical ANDed iN^tti the specified data 
byte. The bocLean AHD operation is perforned between corresponding 
bit? pf the twd Dytes. Each bit position of the pair of Ijytes is 
operated on individually, the result of the operation replacing th-s 
torrespgnding bit in the A-rsg. The rules of thp AHD opsratinn are: 
if the two bits being Afjl>ed are value 1p the result is a i', if either 
hit IS a e the result is a Thai ist C* AND n ^ i 16 AHD 83 = * 
I [1 AHD IJ - L ; Li AHC 0] > Example: 

mt iBieuae e-rta 

ifidfllSAA neL4 ^-reg 

Only the bit posittons which had a 1 in both bytes ended up 
with i 1 in thp- result - The AND instructicin is freqL»ntly used to 
selectively clear individual bits while inaimtaining the status of the 
other bits jn the b/te. This is done by creating a "masK-byte" which 
h&E A 4 in -every bit po-^ition which np»(}fi to cleared (set to 
and c I in all the other bit pcnitioni. The mash byte taty be ir^ 
either the A-r«g or the specified memory iDciiiorrWt the rtwM of 
thB opwitiM Alwiya rapUcM it* A-p»g. 

This pPDcen wdtMs becauBeii A^dtfith stthBr a or i 1 
gives a4 rEftult while a 1 ANI^d with a 4 gives i ft and ANDed with a 1 
glw? & 1i 

ORA - Logical OR. The A-req anj the specified memory locdtion are 
log-ica! ORed togelherf t^e result replacing the A-reg, The booiean OR 
opBratLDHp liKe the AHD operationp is a bit by bit operation. Each bit 
ot the A-reg is ORed v«th the ccrrespDnding btt oi the byfe in memory 
by the following rules- If either bit is a 1| the result is a i. If 
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teiVlbLts Arfl0» tha rtsUtiBfl. Ttiatl«i CI OH n = l ; [] OF) 4] ' 

The ORA -freauenily useq to seiedavsly turn hitg on isei 1q 
1). Like witfi the AND, a ma&k inij5t be created which imiitites Inp 
flesifWl brts to Ht and the bits to be unaHected, The QR masK muet 
hflV* 1 bit on ir\ tht hil poHtions to be set and oJf m the posiiion* 
whi[:h iWd to be maintained. This is appau-f* a* the AMD miih 
Tti«ra. i-fiita miintainsd ihe statua quo. Here, a-fiits have. tfi»t 
rsEDfinsibility. A fl in the masl* Dyta w^enORftd witt i t gives.* 1 and 
vAen ORed with a a give a H. And a 1 in the mask byte- alWiys ffsOlti 
ir^a 1 result El Ofi 1J = I; Ci orftl- 1, Valid iddreaaing niQdes are' 
thff time AS for tht AN^Q imtruciion. 

HW - E>! elusive OR. The contents of *he specified rriPmijry Bytft are 

eOPed with ihs contents sf the A-regh rffplaciTig Ihe A-r^g with thf 
reflult, Liffe Ihe AHD md OR instpuctiunsf this i5 a bit oriented 
irwVuf^on- tht m4*» o* ExcJuaive-Oring are: The result will have 
ft 1 in ^ tli-tpp^.^nn fa- whidi only arw of thi tw b^tffa bHFig 
SORed hav* dm». AU other bit potittona o* the result wiU a 
tAi.v. [iEClHSl= 1; EiEOR iJBfl; C* EOflflJ-frjrft flOHl] = 11. 
S»i ampler 

naaiei* Memcry 

EQR l-BtBilSB fi-reg 



ejieeiie n»w A-r»g 

Th* EOR Infitnidion is usvful *or inverhr^g bits. A 1 in any 
nafiK bit posltitxi will cau» Vib aHTej*pQOfliflB bit In ttw rcwH tg 
have oppoAHv valur a» thit thi cprrtspqnnngmin-thti ipfajtfCf 
byte. A 1 be+areE0f*inguillfrflajltini**4WrimJ.ViH W5U A 
lero intfis masK cy te i^llElUM ttw crrrMpotVling brtfai <hS e*jwt 
byte to ^0 unmoleEted. 
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BIT - BIT test. Tht A-reg is logically ANDed with the conteritg the 

sppci^ied nhffTfpry iKition. The ieroHig js spt if the result of the 
operation gives a zero result. The Negative tril is set if tfie higFi 
□rder fait of the imnor^ laotion is s*i. ^ Overflow biiii sa4 
the «cand^iig*!est-Mertjit < the 6-^!i*^ nf lh» fWiiKry Imiian iA 
Mt. ThB NeoBtive ind Overflow bits are deerrd U thel-^l «nd i-bif 
Dt ihe manwry IncLlianarfl dear. The A-r^giBhol affirt*d by the 
e>:eciJtioon of this irstruction. 

Tftis mstrvction is very useful for testing individual bits of 

byt*s inmemory. Thi A-reg is loafled with a masW ^hich fiis ones in 
thp bit pDsitiors to be tested and leros in the rest. If any of the 
meipory byle's bits m the tested pDSitions are on the result of the 
ANCing operation will be rwMro. Note thit the masK miy be sither 
in ippmory or in the A-reg for Ihw test to iirtirtf. The Negative arrf 
Overflow bits are ut ttsed only upon tht bit configuratiEin ot iftf 
memory bytB howevw. Eiimplt: 

j«5K err ^ai 

BIT yflLI 

m\ BIT? 

e^S B116 

OK EQb 3 

TtW vilve ^he byte flKtgned iol^il MASK is *Si, The 1- 
bit and the Z-bi1 an qn anfl ill others an off. T(w HIT inatruction 
AMDs the contents of thftA-refl) »M, With «w byte al VALl and the 
result will be non-nro Only i* altt*fftie 1-bit or the Z-^Jit(rf VALl 
is a one. H VA.E.I has its high-order bit m, lha progrtm will brand> 

to BIT7. If the 6'bit is on in VALi the program will hrancfi to BITS. 
If either or bit-t ^re on, the branch to fllTlOfl^ will be i^tm. 

The " a " is used in the last ^titemint ot fl» progmi. li 
has a spetial significance tc The 

Aasembltr. UsBd in the operiml fteld o+ an instructiof^ it is LiKe a 
symbolic Jabel except li refarervies the currant value o-f the Location 
CivHer. Here, it performs the -function of ascigning the valia of the 
IdcafiDn Couiter to th» libel 'OIP. 



inndtTiw VIC 



ADC - ADA withCarrj. Adflition 15 ppHorinEd with the A-rtgt the 
Speri+ied mt mony localjon anfl the Carry bit. ( A-rsg ) ? i A^rpg k + [ 
Addr ) * ( zirry i. The (..J 1^ ii^d hcr» mean "the cantsni^ 
□f. The rpBult replaces theA-reg, The moda d* *rilhm*-lic is 
ditcrmined by tha HUtuEDf thEDidndlntodtbitBt ^ tinw tta« 
iratructuin 14 f M acutfld' 14 sett ^ mode of uHHtfon 1« the DkidaI 

Miw is ftjfihf IDA jrw'trurtiaFri 

Binary iddition is qul-ta ^npl*. Itiajusi like dedmal 
addition ancapt iht highest number you have- io v/ary about in 1. Th« 

1 ■» 1 ^ je ^2 in decimal > 

The 'tinird BKiPif^B the Dnlj' -EinB which is (Utf«n«rit Din 
[ieciinal uMilioFi. Ufrcn wc piirof bipArv runben-wlth mar* thin 
on bit ^acpt we procftiil from right Id lift jUst like dsdmil 
addition- We add thp two bits together and it ths rfttult is greali^ 
than 1 we have to carry 1. ^n, 11*11=119. Domg ttiia aflflitton 
one sttp at a limsi UKing the rightmcst biisi 1 ard i 1 antJ iflOinci 
thsm tty the above rules, we see that ttie answer is or wiih > 
carry frf \. Ne«t we add the rwKt pair oi bits plus tht carry- 1 4 I 
+ i = <1 * l> ♦ 1 = ifl *- 1 = ii_ Ttiflt^ 4 I with a cirr/ o< I. Kota 
that 1 + i + 1 - 3 in decimal and 1 t 1 * 1 = 11 in binary whi-ch ib 
ttie binary equivalervt of 3 do-cinil. TM Bpat you Hj^vs tfl r*in«ibir 
binary Addition nf two ntimbB»»-0 4 8= t ; 0+1°!; t * 1 a tft 
(fl carry 1) ; i 1 1 ■» i = 11 U tarry ii* T^e^W imburtion dnvE 
this birapy Mdition wcr^ iop you, vo you might not'TWed to krxMr it; 
On th4 other hanidf yoj probably will when you go to debug your 
Glltctic iSobbler OaM. So yrxi might ju^t as wsll learn it noh. 

When inDpcimal nodep Xhr A5f^2 e>:ppft5 the data Lt ia adding 

to be tn. ^'binary ceded decim&J" 'orcnat. Thi^ is yet another data 
format. In ^CTf, tKe eight bite a byte are interpreted to be two 
four bit decim^J fligits. Eith four bit digit may f>*v¥ tha tifiadtciiul 
values of If thare is some other bit cDnfigixa.taan in ^ range 
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of A-F in Either half o4 the bytes being addibt th« results will be 
urwieinirig^uL When the ADC is executed in Decimal iFiodep th* two low- 
ordtr digits irr add^d ^ny decimal »rry ia addsd together with 
the two high-order digits. The carry bit will be set if there is a 
dedmal rarry tram the additifliof 1h& high-arder digits. 

It is starrdard procedure to clear the carry bit bc'orE using 
the ADC instrcjction because the Carry bit is addtd into the result. 
Th£« ii a nice f patLrv Mrfien ycu arv doing multiple prvduon lEldition 
auA ac adding two 3? bit numbers together. The carry bit is th« 
ne«^ coniunicition betsmn the EUccnsivt bytes oi the additiaru 

Exampli Of 3Zblt nultiplf pP«dilon addition: 

LOX tt3 4 BYTE ADDITION 

CLC 

NEXT LOA IMLI ,X 
ADC yAL2,X 
STA 'JALSpX 
UBC 

BPL HEJfT 



SBC -SuBtract witti Carry, «p*d4ied byte m memory ind me 
inverw of the Carr^ bit ire aubtractefl from 1h# A-reg, replacing the 
A-reg with the result. That isi <A-rHg> =- (A-reg) - (addr> - [1 - 
(Carry)]. The Carry bit is set if ths cortentE ot the A-rsg art 
greater than or etjual !□ the value beirg subtracted iroui it. The 
Carry bit is cleared if the value subtracted ts less than the cnrtprrts 
af the A-reg, In deciding wheWer the cnntentb of tht A-reg and the 
memory location ara graiter than or lesss th«i one arother, the 6597 
in^rfffatfi the values as unsigned integers in the range of 0-2??. 

The c*rf^ bit is liitt an inverted toTTDWr [fa borrow is 
r«)i4r»d* the Garry bit- in*. If no borrow ii required, the Carry iB 
t. Th« Negative 'andlfroMtciiV HeibUtd on th« result trf'^ 
subtraction. 1?ie Ovfpflow bit is setil *'lwa'E conpleffiejit oveHlpw' 
ocurred. Valid addre«ing moda* ar« ume aa for th« LDft 
inslnjction. 

The norma; subtraction procedure ts to set the Cirry bit befora 
the SBC IS- e>:?cuted. Using the SBC to caniuare two values requires 
testirtg the Minus bit after the ^ublrjction, is complele. 

If the desire is to branch tfl PflGA i* the contents of VALl 
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ire \m than thfl contantE o-t VAL2 tha following progru would ti< 
used; 

BEC 

see UAL^ 
BKl PRSA 
OK EQU 3 

The rauhrye worKc +Dr unsigned numbQPS. H i carApirlfon 

is being mide nurnbers which mij- fiave negalive values^ i mar* 
i:i]mp1eif routine must be used. The po5bibih~ty oi "negitivt avBr-fkn/ 
enists w^vn subtrictinQ numt^er^ which trs intended to r^pr^ssnt viluti 
in the pangt ot 8 to I27f -1 to -128, If we try tn subtract IS ^rom - 
i24f tht rtujlt would bt -134. This is out of ihe ringe of nvgativa 
nunbers. Tht fi3tZ lati ue Know^ thi't if this wis a signed operitioni 
4h« rmAi had "rv^Btiv^ overflow". "Rids la deifw by matting tJw 
Overflow bit In ih( Processor Status Fttgistar. The vilua Whidi enda 
up in the A-f*9 Is 123 (?5A-134> in the abovp ^KamplE-. The unaigned 
equiv^trvt of tht -124 i& 13? 125ifi-'l24>. And 132 - Ifi - 122. This 
penitive result gives i -ft-lse indication d-F the relative ma^niiude of 
flw two Eignfld rumbers. When worhing with -signed mimbers tfto 
blowing technique ii nccesur^ to naKe iccurite compartsDns of 

SEC 
BSC 

BMl PRCA 

BPL OK 
CUmi BPL PROA 
OK EGU 9 

Pnilivi ovtrflow rinutur th« une w4y> Bi^iposE VAU hti 
the value of 124 and VALE bat the value of -4- The intention of ttw 
liwvr ppogr«mi«tobr*nchtDPRaAif VALl islMBthanVAtX f^- 
MJ - 13i. 131 is out Erf tt« nngi of signed numtari (t-l37l- 
PMitlve OwivFIdw Dtnral. The ^42 ^tflls i» thisirtttw uiw way, by 
bvtting «n CMD-faw bit. Ddeb the pPOgran ^wrt( for caK? t7£ 
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ifi not less than -4. The overflow bit was set by the SBC. The branch 

i« taUr tD CHICHI whsre the Negative bit is tested. It i« jjn beciuse 
the valup in the A-reg is gnat«r than 127. It is 130. So the branch 
is not Ulttn ta I^QA. itwoTtttL 
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DIP - CoKPirE. Thf magnitude of th« ^p^cifi^d memory location ii 
comparod with the magnitude o-F the A-reg. Tbe Zero and Negatjvp bits 
are set as though a SBC ha.d occurred. The A-reg is not ipodifctd by 
instruction. The c^rry bit need ncl b& pre-set or cleared before 
eifecuting the inEtructtor. The carry bit is set if the compare finds 
that the A-reg i5 greater than the value of the contents of the memory 
locfttion. The Overflow bit it not affected by this imtructiDn, It 
is tht^^efore net poMltil» to u» the CHP to nalM ^agnitud* 
caiBfMnBton^ rif signed numbers. The deui^iticip of the 
inslructien iUuatr^tos th* iiihraE^je. ftMv.KCDir^^^ this. Valid 
addressing modes are ft« s^ne as tor the l:I>A imi^uction, 

CPJC - Comp^ce the f,-rvq. The X-reg is coitipared to thf contents of a 
tpadfied memory location. This instruction functions eKaclly like 
the CHPih5tPLiCtiDinfti(ce[rtthereoiaterbeingcomparedisthe I-r*g. 
The valid addretting inodes are Absolute* Zero Page and Immediate. 

CPV - Compare the Y-f^g. Th* ¥-i»eg is tompared with Ihp mn-tantB o* 
the fpKitwd eie^orjF Ipca-tion. Thie inttructiop fgnc^ions enactly 
llHi' t^ CHFand CPXinstructiDns. Addrns^ modes ve 4ie sam* a« 
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NOP - NO operation. The amazing HOP iostruttiop dots absoluttfjy 
nothing. 11 Causes the 6Se? to sp»n its electronic vrtweU for ■ few 
miCTOMConda. It taJtte one byte n* memory. 
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Th» Toolm 

There -dr^ -five ^-twar« -toal^ whids m^k? ijp the standard Kitp 
The Editor n used tn create, modify and save a-sseinbly Unguacfe 
program! Id casutts or diBKetl*. II pertnrms wHam error checkirig 
functiDTiE as well. The Assembier read? Ihe asseinbly orngrams which 
were crutBd with The Edi-tor and Th» DEnoder dr>d praducsE a marine 
linQuAffi pPCQri-n listing and nichire language ioaC moduLAS on cassctli 
or OiaMette. The Lender p«aii9 th« loLd mddultfl 4Pant «S«eHe W 
E^skette into mrmop? where ^wy m*y b» RUNi; mnglaiitpped or SA^il. 
Th* Konitcr ciin nngli-fltip through aiiy ntadiiriB language prDgT*a<ni 
dispJiylrtg iha various registers ^nd status bits at every step. It 
also allci^fi the Pisy e>[anLtrutLar and modi-ficaticn o+ niBinDry iDfatiorLa, 
The Dvccder does ih? oppDsita of The j^Escinbkr. It renJs machine 

languaEfe programs -from th? compijt?r'« iTiemary and converts thetn into 
aE»mbJy language whii^h can (hen be saved cassette or d^sltette 4or 
re-artry intcThe Editor and The Aasembler, Listir^gs of tt^e a-asembly 
language program are also printed Id the screpn arKJ/or the printer. 
Witti tht e«tffndt[K«a.1urt vBpiion Qtthe liQt tGeeenthange offer at 
end Q* buDiOt the Edtiiff and Sie Asaembler have 6esn combineiJ into one 
(rngrami ASMEDT* VBraion requirBS a minimum d# 3K ot ejpansion 
msnory but latiswr to ^se* 



First Steps 

Qe-fora a11#mptir^ tg uSe any *he so-ftware toolst bickfjp 
copies s^iou-lQtre made anff the Driginal tucKed awfay *or sfl*e Keeping. 
Safe Keeping -for any m-agnetic media means m a cool dry place away 

gQuras 0^ [iM^tic flui4 uch u TV ^tsj )a^%pta]ant 
iransfermiffi, power supply*, esplodinfl noclear weippnsetc- 

To bacK up yoix programsr load t^fliT cm.at a time usirif) the 
usiMl proctdurp: LOAD k:<mkj:>l far LOAD KKXumfie fordisHettB) whir# 

xt]ixKx IS the program name. The names of the programs which you 
should -Find on the distributed media are: EDITORi ASHBLR, LOADER, 
HONlTOfi, DECOUEP and A5MPRT. After loading Cich prngramr save it 
either on cassette or disKette a^ you pLease. Again, th? usual 
prccvdLre is followed: SAVE or SAW itjixxvkpS^ Be careful not 

■to MVf flie program ipntc the cassette y-ou Just re*d it from as you 
wQI no doiilt write over the ne»!t program on the tape* It would be a 
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gtud ideft to eich progran on ila.own casEette t4 you don't havt a 
disk isysten. This will cut down on ttw tini 5t taWes to ftnb and load 
the pragrams when ycxj use them. 

H you ejiiperienc» trouble loading anv the programs, be sure 
you have spwlled the name right and that the tape i-s if\ the proper 
position, it LOAE EPRORs prevent you -frorr* loading the prijgrajii or the 
program Just doesn't seem to be on tJie media at all and you are sure 
^DiP wchinetirtinoaodwariQpgQrdflr, yoj ihould retim ttw mdia 
to French BilK for a repUcement.. Voj have thirty days in v*idl to 
^ini i^ut if you have a problem andto return the fairlty media. A 
rBplaiciannt will bfe inidt at ro chtrgft. 

Iht Editor 

Load The Sditcr in the sarria way you did when yau made your 
bacKup copy. Once it is loaded and Hh^ 5cr«er display ^ly^ READY, 
type RUH. Tbe screen will change colors and the cooyright mp-ssage 
willappeaTi followed by the pronpt, "HAX?". This is the only time 
this prampt appp^r^. You ar« hnng acKed how largi an Hventbly 
language program segment will you be wanting tu create ofJflild' It^ 
only ipportant toanswfP witha nuoiber at ItMt DfW^reateP^aiT tt>e 
liirgeEt numtivrof Btatemtntsyai npsct tohan Inany ugmtnf. If 
you have a VIC you can always answer 90. This means you will not 
the allowed to create a program ^egirient. larger than S7 ^tateiErents. 

Thai is about the most you cin set into the minimum VIC anyw&y. If 
you have some inemory BKpansion, you can figure on getting about an 
^Mtra 59 - IS statements per oi expansion. So, with an 8k e>!pander 
you can figire you can create and assemble a program segment af about 
Sflfl state nents. Later on, we will get into brealting lai^ programs 

into «uBiUcP uor^tbl* wgntntt- 

Top noWf errfeP^ regv^Mof how niudi expiansiDnyouhave. 
Do this tar toying [R]". Hot! that mt all Hmn in this text we 
will UH'ihi -ERr symbol to refer ta the MTURN Key. 

You Should now see "CPLDIHS" in tlie center of your screen and 
a '"^^ on the following line. You are being asKed to select a choice 
from t^e menu of [^iooE* Briefly, the optioni are. C - creete, P - 
print, L - Load, D - Delete- 1 - Insert, K - Modify, S - Save. iNote: 
with the Extended-Features version of the Kit, the additional menu 
□ption "A" for Asaemble appcart after ths other editing optionali 

Since we are now going to create a program segment you shoulfi 
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Vty '^C ZTil". Th« flcncnshoLJ^d new clftr and ' ?" " Ehould ippear on 
th* MCondlintDfyoif display. This is Ihe pfOffipt -for t-nlsHng ■ 
line Df « Murce prograni Hgment. It alwi/s appears ir tha Eam« plftM 
□nihe screen. This i* the "edit-wirnJow". Whsn we get to modifying 
program »gm»nt9 will see thit lines 1o be mndifyetf will apcu-ir in 
Hue une edit- window. 

Enter thi following assenftly language siatemflrrt withoul htttina 

L0UEQlJ7iM 

Be sure to £eave a apace after th# labeli LDWp and be^re 
*he mnemomc, EQU. Bb sure rtoi to leave any space heWen the EQU and 
the operarwd, 7fifle, If you made errors in keying the ^bpve statemeiTt 
y*xj may move the cursor io the error with t*ie cursor CDntrol keys and 
CDTTKt it By typing over the error or by i>£ing the Edel*1pl arxl 
CimirtJ ttys. Until ERJ is hit, changes may fie made at ^11. Cach 
Htitinient imtered in the edit-window may be at most 8-6 characters 
long. TOs i* four ranftotB scrwn linps^ 

QncB you hav« V\t EtateinEnt .fteycci Jtst ai shown, hit CR 3. you 

should SH tha Etatemvrit tppBira 'few linflElDHAt on the screen with 
the lin» numbrr 1 on thr left and witti a Eptce b^iwtm the ESti ind Htv 
7fi*8. Mat having to toy the space betwre en the mnemonic and the 
operand is like an automaiic tab Jeature and saves a heystroMe. li 
C4n be contusing though^ p'pecidily if yoij irt used to other 
assembler /editors which require the EKtra WeyatrDW. ^egardlesfir this 
IB Ihfl format of tvery stilamart yoii mU Snter with The Editor. The 
Itittl ^Id is optional and if onittedp & single space mus? preceed 
ttW Bnemcmic- Tht first space after the mnemonic signifies the 
blaming of Ihf comnflnti. In BMirnplfl no EarFiminla hftvc been 
■n-tor»d'. 

Now the edit-window ^KXjtd be blajik e^cepi for the prompt 
M is time to enter the second stateiHnt of Hie pTDgram- Key Itw 

MBGBynT WORKS 

The IdKl field is "KSIQ". TTie mnenonic is the pseudo-tipt 
'Wrr, and the ofierand is "IT U'C^WS'* Thts would seeei to be a 
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tont^ictiditi o4 whatwas i«t previouuslr stated about the first 
spflte Btartihg Vie tomiABnts. Tt is. This is the only exceqbttorvto 
the rule, Whrn the first charatter of the opewid field of t BYT 
instrudion isa""'p then tig comments are allowed and the entire 
character string a^tp^ the " ' " is considered the operand. This 

gpirtnd typv cail^d i Mivril ^trjng- 

Uhen the statement js entered correctly* hit LRl, This 
statement should rvcw Appear a-Fter Statement i on the screen. It is 
line i Z of the program being written. The edit-window is now open 

iga^ 

Enittfthfst^mtm^ 

Hit [R 1 when you've got it right. 11 ac9«3,red like the others 
down below the windowi right? U should hAv«. Kow» the froblen Is: 
a ia in incDiTect ^talrmmt ■ It ihould have bain: 

To fix ii, we have to leave the node of entering new 
statements. Th&Eie dEns by kp^ing [R] witha blinUUnein Adit- 
window. Do that nc3w. You should «ee a relufn of the original nenu. 
-followed by the ■ ? To fix a wrong iimit is neceesapy to chotjse 
menu option "M" for modify. Dd that and be butb to hit [fl]- 

Now the oromotp "Lilt'^' should appear. This prmnpt is used for 
the Uf P and 1 options. It means which Lin» number (U and how 
many lines ^*)^ For ITie Mndifyh the secHsnt number -^hpuld ilways be a 
"l" since we can only mcxlif y one line at a time. Keyt 3,1 [R} . The 
statement we jjst entered should now appear in the edit window- At 
this time it is possible m#Ke iny nmJificition [^eind By using tfte 
curwjr control Heyst the [insert] and Cdelete] teys and toying over 
Afvf characters ■n4uch appear In the winMw. HOve the nrsor to -bw 5 
and toy a 4. You un hit Cni now if it Ipohs Uto it should. There is 
no need to move the cursor to tin end of the line be-fore hitting [R]. 
Kow the fined version of line 3 ehould have replaced the VffoneEJus 
oner The menu should have reappeared once again. Well use the 
option to see the altereO statement. 

The Print mode option allows you to list your segment to the 
screen. You may start anywhere in the program and print in bldcKs of 
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tny siM. Key"P-CHl. Ygu will ha th* airsaH^ fafliiliar " 
prompl. Ygu frMng iskffd whsre da yoa want to bigifi listing 
pro^ui and how manjr linos do you ^^Fant IjBted. We only have ihm 

MliraoitwOLddlHreiMnablP to Key 1^3 but +or the sake □* 
■dUcafion, l,i rRl&ictati If youdifl that* y an will see tft* 
first line was diaplaysa and *be menu PtiipptirKi, How, it you Umy 
only [fl ] the listing wiU amtin^ witti the wxt hlodt nf N iin^t. It 
wiU print the un^ number of lints as ^o^j specifMd ]»t t)ft«r 
I, This la most convwnient when ynu havo a Iv^ge program and wlih to 
Mf 1 screcnfull at a tirrP_ Ancwenng 1,1^ to the initial prompt will 
raise the tirs* 15 Unes Id be fliiplaved. And each additionil tiine ypu 
hi* fR] after that you ^ill gpt afwth^r 15 lines. Hit [Ri ag^in and 
IhB liit line will apfwar. Nate trrat it was thmgpd by yejr 
Modification process a while back. If you hit Eft] any more, all you 
Will flpi is the rainu again. 

We want tn c^rrtiniM adding morp statsnisntB to our program but 
it wttild be a iiFl««etoirytnwtiM by re-entering the Create 
mode. ThatcaiHBith* whole ilat of entered staWmmts to be erased 
and the state went number to bo reset to 1. DO NOT TYPE A'C^ AT fWS 
TIMS. Once the Create mode has been abandoned to fix a statement or 
to Print the ae^ment, new Btatements may be added only with the Insert 
optiDn 

Ttv "V commandt will cause js to re-enter the si atentent-inout 
muite. Key " T now to the Menu prompt. We won t bather to tell you to 
hit CR3 after each entry any more becasise yQU already Hnow that i» is 
peffuired. 

yciJ Bh^PHJ the -Lifl?" should be staring yoj jn the 
face again. For this node, the r^rttj^Bponee is tl» Line a.fter whiiS> 
yoj wi5h to insert new stateiwnta. hie ishow aany linee do you 
wish to insert. Wien all we want to do is 1p contlnuB adding Ip the 
end of the program aiKe nowJ we Pnter the last line nunAmr of th« 
program and ihe rvumber 1 13,1 in this «seJ. The number of Imec to 
be inserted is very important when yw are inwrting lines in the 
middle of the program. You couid overwrite soma of your -rrograni if 
you tnt«r more than you wy you will. You will have lines duplicated 
if yoo entar less. When addinri to the and. however, we can add as 
miny jft we want and only specify "1" without havjng any pniblens. 

m3hDiil(l«rttP'"3,r now jnd you will see that the linna of 
the progf^B up to and Indiiding the Une L tftll be iistod. ^nd tfif 
edit-wiftdow irorapt wijl be hatSt waiting for you contlra the 
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entering of your prngram. Uien entering prtigram lines the most CQnimon 
error Ifi to sithsp -forget to enier a span Belore the mnsirifirnc or to 
enter one after it. If you get stoppeij with an EHR message it is 
probably because you broke one of those rules. 

ERR 1 means either an invalib mrvnionic was entered cr (nor? 

than ofH space or no space iinmediately preceded the ihrenLonic- ERP 2 
means that either aji addresBlng mode was used whinh is invalid for the 
flnmanicor sp«u w4ifi»rTterHf ^nnwttiately after the ninemamc- 

-KrBt ifViiff ■tatenenti of iHe following pragram have 
already tcenentewi. How enter the nin^ndtr. You may experierKe 
occaatonal deUys trf a second or two afterjtntering Hie in&ut tine 
before 4w pronpt fetumSn Note that there ii a it character ir^ui 
buffer which allows the favt tyf^st to -get ahead". 

LOU EGU 76^9 
MSG BYT ■■IT UORKS 
SPG EOU 648 SCRE£N 
ENMiSG EGU 3 
L9*SQ EQU ENBHSMISG 

STA *-e 

BTfl H 
LQOP LDA MSG-1 ,Y 

-STA (B) ,Y 

BnE iOOP 
KTTS R£TUm 
LAST ESU ETiTRY 

The RT5 may have caused you a problem. It taKes no operandp 
so the "RETURN" must be separattd from the RTS by a space since it is 
a coni ment. 

Once you get all of th*Ee statements entered, c^itlhe entry 
■orte thfM.0»Cfcy^>wlaftth(O^ste ifioflt, i.e. [R3 on a ^lanK edit- 
window ilne. How wotOd be a gotsd tine ta chedf the pnsgram for 
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Jt turns art there miitake in^t way itfbt- pi^an WJfcE 
written. Far it to worK correctlri atAtflment 3 nunt bi movtid th«f 
ENDHSGfollows tnnwdUtely aflar MS&, AJu, an EflU LOW+LENMSGnwds 
to b« iiWrted jLnt btfcn state ment 6. 

To AccGinpliflh These mcdifka-EiDn^ you nc-cQ ta -first dftlFte 
stitfliBPnt 4. Tfou should have finished the insertidin pracsss d-F 
cptiting Iftt ibovt Hgnent 6y hiHir^ Cfi] with a blank line, Ths menu 
should be on thi- Krman now. Give it a "D" for delete. Tht "Litt?^ 
TOV Btky be nipondKt to with r Mri", Thi-s is to delete dtm ijnt at 
lim humAir 4, Om it ii donti th« nenu vnll raapppar, 

Ndv io put it back where it belongsi you will need ta dd kn 
Insert. Ydu should Know how to do this now. You viil want to irwart 
-one line i*tffr line Z. Uhrnyojgtl ftff ■ ?- pi-Mef the filiDMSe 
stat*mert followed by P»3* To get out of insert nwde hit IS] -wtth a 
bianW edit-vinddw. 

One mE>rfi thing tD do. IntsrttEie "EaU LOW line aHtr line 5. 
Haw4 PB'list the entire program with the P option. It should look lila 
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If BWffyttflngitocte plghtt youcinniPWMye the Mflnent piu 
JjB.t created. If a^s iimn, uh t^it modify or inurt or Mlete 

If ytn hJLv« a casHtte veTiiOn of ^e uftware toolii pla.u a 
bUnh rassette in the recoriter and tniHe sure it is rewDund. Qive the 
msnu An '5" for Save. If you hive the disKette versiDni put any 
disfette with a little space left or it in the drive jnd key the "S" . 
You will be asked the "hAH^?" which you wish to aasignto the -File 
which you are ibQuI to creatBi If you h^ve i OiEki you inuEt give it a 
nime. With cassette ■ the name is reCDmviCnded but optional. Respond 
with thte name"TE5r. 

Ttu SQurcfi pnigram SB^nient will Tuw he saved. Uith cassette, 
you will be anMed if the rtcorder is "OFF?" before telling you to 
"FrKSSPLAyABDI^COflD*. fnunetflonlyhltwtupnHfflaUiJit a 
pauu b tnauru th* recuntor Wksi net left on from the Imtt irvJt, 

□m the recording is firdshedp the menu will reappear. Ndw 
thff first Maalon with The Editor is ousr. To procesd with the np-nt 
step* assembling ^e prDgram with The Assemblert either select the "A" 
option of the inenu if you are using the extended-feature version or 
prriE thB STOP and the RE5T0BS keys timE^ltaneoufily and proceed to the 
next chiptef'i 
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Tlw Aii»btor-Thtpi^rifflMflmnTtto*Aitflw-ttTTi.[diW^^ to 
belr««Utfdint0 4iA«lmidtii»lirigt«gt, ThU S» tte fmcti„ of 
■ni* AsHinblH'. It can rv«d in ind fransUie any ruidnr of canmutlvt 
iorcw itif^mtily lir^u4g«} iegmanti, Fop Mch tfQrMnt ptulr ii wdl 
ganerita d r»prirvt of the oncjinal vxrcf atitamftnta, aatti foUowwl by 
ita rriKhif* Unguige tquival^rvt. H wUl prinl tha maOiine laiwiHdi 
in BithechtxadftdmalDrdecimal. It *1h optiDrull^ producK ilT 
qtw:t (m*tfii™ languagtJ cxjtput which Tha Loadar tan thin load 
into ttw tped^d himry loca*ic3n« of tha CDiii(XJt»p, Mth ttia 

irfthaKil, IhiAiHinbLFrit t pirl of 
ASMBDTi th» AaHnAltr/BditDT conlrirHtlDn. Thn only ftjictional 
d^*frwe with ASMajlinilth*«MBW*rf»rttenirfABHflm- i.ihat 
iftrKt Piling ai the gatwratHi maehUw leigtugv intit mCRiary fa «i 
□Otion of ABMEDT tnd it ii m\ poaaiblt with ASMBU?. This 4tAt»n, 
Whin uHd must not *1timpt ia POKE machine languige into m portiwt 
of jntmory which is uiad by tha AEKEDT proflpam it*aM, Mlhfs will 
MUW hH di-atructiQri(rfA&MBDT- Tht PtKB option ia lalwrtad bv 
afwwffring "Y" io tht -POffi?" ppompti 

two vapftion of Tha'AsMmbliir mclucJad on 
ttt MlrtbirtlDn n*du. Tha mmmd viralon, ASMPRT, outputs to th* 
printer pathfp than «raan. To lud 7Ti« Amitmbliri hav4 ei^ir lh« 
»mtt« dP tflitetit With th» aavvd cnpy of ASHBLH far ASMPPT> in the 

■PpropcutE »viMtp»corArcirdirtdriv^*ndl^^cyjJAfi«BLB- or 

LOAD AB*lBLP,e' :f ^du hiVt tha d^f:;ttt^. Whtrittw WADY. u»in on 
ma ao-aanB Kay 'HUN', 

You nirill new git tht tirnt "KAI?- tmaition uwith Tht Editup. 
Htre, again, you ire baing asiiad 4dp tha maMimurB aegmant «n in 
numbar of daiambly langutQc atattmtnta, Rtipond with 'Sfl [fij", 

Tht ntift prompt wiilbt'D/H?-. Doyouwifih to get Ihi 
Mchint lafiao*ga in decimal or hairadtdnU? If you hay "D CRJ", tha 
nmAi will bt dadmal- CKhtrwiaa, any raipcinaa Including [R] wiU 
uuMhax output, ftyi-HERrihlttlrw. 

Mow -HwfroMpt Should ba^-KAKB?'. .Q|vtit«ttniM o* 1h# 
Mira wgmtnt you cr#*teiJ with llaffelitflp. In ftaxrtviow flMWrttp 
wacpaatadasoir«fUan«»<|-TBBr, TKltll bitlfttym ihoUdlflti^ 
now. Withcai»Btta»i#yDuhiti»tra:,1h*ftrrtfilaftiiaidonftB 
uuttti ^Inuwd. If thimnlirwuaKt youitfiU git tiw 
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"PRESS PLAY ON TAPE" meaaaija. Dosa. 

Now tha -hi* th&jld bt loading. Although thii it a t^«ro-fucc 
AsunblePt thi9 is th« only tima the fii« actually ban to ba raad into 
the [OETiputar. You can be aira tha file has batn fnnd by ^vtvnmg to 
tht rtcorde-r. Thirt will bt a Bliflht pause tvtry *tw ttcond3 as tht 
tila ii bair>o pruxcsud. Somtinasi if cacutta pacordapa apa not in 
tht baat of haalthi filas [irtattd with on ppogpam do not load vary 
wtll With mthtp progrim. Filt-crtAticn h» Itat butltrln fault 
prcvvntioo Vun data pragram-natian and lo filai an mort prona to 
load arror** uml syaiptwt of thi* prDblam with "tht AuanA^p Is 
ft -VntlHO TOO LDHQ° crTor. You can try 1o Hud it or ycu night 
hliva fa ra'-craata it with Tha Editor. !f it it a paraistant problani 
you might he wall a-dviaad to hava youp racc3Pdar tirwd up. 

Whtn tht filt hasbten tucctithilly Lsadffdi thr r^e^t prcmpt 
appt«r«. "OUTH?" ig paquastu-ig a name to ba aisignad tha machine 
liAflutflt oiit^ H youdoTi^t wi^h ta create AM at thit ttffrt 

you must hit CRD only. Do that now. 

Now tha prngrin wilt start io ba liatab on tha scraen. You 
rirauld u« tht first t>n lirwi of tht prcgrim which wiitTHtcd with 
ThaSdatDT, Aftap aach Una of E<u^ vhoild bt Kiint ^Iti Hi* Unt 
ni^ov* on thalvftt foUowtd «iy ^ Udpm of wtiara tfw nudnna 
linguigt wiU end t^it follnnd by tht u±m1 aichdnt Ungut^v 
tpanalation of tht pranading a.uambly languaga atatanant. 

Tan cucTi lwo-lJn# ttattntnt* will b* followed by a single " 7 
Tht AsitmblET PAUSES, every L4 itatemtnts to lit ycu vww 1hB 
acr<an and to tail it vi^wn you are ready to have it continua. To gat 
tha naKt hatch of 1ft stataniants it is nacasEary to Key anything but ' 
/ A' J " will cauu tha aacairrbly to bf pr^iriAturvly tndtd and ■ 
return to the point of asKing "D/tf?". [Rlisthe normal pasponsa. 

Tha rvat of th» pro^Bi should now bi manbltd and listed. 
It ^ ba fc^bwad by tha prompt. If youhava all yw n*M 

fron Tht AaHBlOtr you nay want to IcnBlmtf the pro^An by simply 
pratsifig RUN and RESTORE sinultaneously. You may wvrt to asaanble 
another ppogran aagmant at this tina in which oEt hitting CH ] will 
wurh. You tnay alio rr-iBEtBblf tht unw sagntnt now wifiwixt having to 
re-loid «w soLira fila. That is what we vdll do how. ifcy [R3 totha 
■BHD?- prompt, 

Wt should bi bacK. at the "D/li?" question. This time > anftwtr 
'D" for dtclHl. Now for tha "HAKE?" promptf giva a - / " folknwd by 
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CflJ. This ttip way ta fiptcH^ 4 re-iBB»mbIy frf tht »ine -ftli 
Without hiving to re-loid Iht sourer ugmint. The 'OUTN?" prompt can 
new bE amwered with a filf nime tobff i»igr«d to thi d#<iirfd loa^l 
wgnspt. This tin* w* will cnati one, Enttr "TKST-L' followtd by 
LHl, If fDu have thf ca&HttB vtrsiont ynu chojld gel i '"□FF?'* prampt 
now, LikB with Thslditor, Th» Awtmblep is trying tcj protect you 
from your own rwgtert. I* you had IHt tfw rwcordtr in PLAY mods from 
iNt fill, input phftMi Hit /'^wiold^r would hive thouQht thit the 
peurder was rtady^ to record. This proiipt isyour m To put ths 
p»^r msBtte in the rKordar ti the i^urK» poflitim on the ■tap»i 
o™ thati* d(jnff. you miy hit Hmv tfmlPRBHSf LAY AND iWCDffll ON 
TAPE me;»ge viil appear and you s^olJ^■£l kdlow cptftrs. 

H you hav0 done ill of thai, the recorder will start 
writingf the Lsting viU bsgin to ippeir on the serpen »nd this timt 
the addresspB ar>d generated machine languagp be in decimal 
inilead [rfhM. Svenything iIm is the sam*. Vou will noUcB the 
retordep or disK doing its -tfrnifl evflry once in a while gs load 
Mflinent* aro bair»fl written out- At "EKD?" tin# the output tile will 
Glow- tu ncBtf hive t tils saved to Upe or HisK wt^ich will be 
ItMdiblf by The Loader. 

Thefe ire two e-rrnr messagee which tht ^tiHnbltr tan flerawit*, 
"ERft 3" sigruflftt a reference in the opertod field toalitJel whjdi 

frfls not been defined sn^'vhers in the prE>grini. FuilDwing the "KRHa", 
the &*ftnding label will tie printed. After the label will appear the 
actual mschire language err-Doeously flfritrilefl. ERR 3 messages may 
also appear before the listing of the prcgrarn begins during the tile 
input stage. Thew mBtBi^e? flag EQU stiTemeMs which have labels 
which have not been beifinad. See the AEsenkbler specification chapter 
tor note iHormaitionirtEQa BtatenerTla, 

■ERR 4" signifies a r*latiw hr*nch instructiDn with an operand 
eKpresslon which rotnputes to an addrass ^Ich is out of range, 
ffelative brin^hBs may be to iddnKes which are d mdxinun of iZJ bytea 
beyond or 128 behind the address of the initruction imnwdiately 
foiowing the hrandi instruction.. The Hme infdPmation foUoWB the 
"ERR 4- message as the BHR g. 

The Loader - The capability to wntei load and run a very large 
proflr-** isprmicW-fOFe™i.tht ^naUesiviC-2e through th*coffll»ined 
uH of The AsEenfaler ind The Loader. Large programs may be braMen 
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into segmerit* whith can fit into the meiriory space a-f The Assembler. 
BetajSB The AMeirbler tan iTeale kid ^egmpnts, the space whcrfi thp 
machine language progr^in is designed to reside is not limited to that 
which is left over when The Assembler IS jn memorv- That is, d 
failure Df some d^^mblar fiyfitems is that the a^^^mdJtr directly P^HK^ 
the machirw langua^ into memory. The fBempry where thi assembler 
itself resides is therefore not available top nacTkirw lar^uage 
pragrain unte the ^sGem&larwuldbflMlf instructing u.it wh 
Ustiiriiling. The wdution ii to have-tfie asstniblir save the machine 
UnVH^e proi}ran umcplace where another program can load it into 
nenoryi This requlrea & loader programi If the Luder is a ^ort 
pro^rairr it will allow the maitimum possible space -for the machine 
language. 

It IS also desireable for the. loader to be able to input 
multiple load segments to better handle the large proorun. ThisrThe 

LcLder is and does- 

The Loader 15 wri<1en inBASK and because Qf the way BASIC 
handler string variables) it might de necessary to "protect" your 
machirw language program fnjffi the string vari4bl*s nf BASIC. H )'ou 
are u^nga ViC-withSM or leul Before leading the sample p'ogram of 
the previous chapters H iaHLIw necesury to met the "TDP-Df -fiASIC 
and ■'TOP-OF-STOlNGS''pQdntBTBinttnipagei TKiB should bff done in 
the following vay ' 

PDKE55 >PGeKl? D^POIS?^ JVRKQ?) 

The Loader is loaded xjstliKe The Editor and The Assembler. 
The prolan name is "LOADER". When you RUN the program, the first 
frcmvpt asKBa by Tbs Uudef la ?NAlCa?r» idting fof thv rama of tfw load 
seg ment crtfateti with The AsMAbler, For the purfMU of this tutorialr 
place the cassette with the tape created with The Assembler in the 
recordtr (or th« disHett? in the disK drive? and key the narM "TEST- 

r. The usual' PRESS PLAY ON. TAPE" message will appear. Do it. 

The tape or disk should now do its thing as the load module 
gets input and the apprDpriate memflry locatLvnaget POKGd with the 

machine language program. As each load segment completes loabing. The 
Loader will ask ^D^ the HAHE o^ the next one. If fhere are nn more to 
lEudp the response should be '/". For ttiis demonstratiai we have only 
□rw segment. The second ti,rae ^ "HAHE?" prompt appearSf key '/'. 



A1 Ihia paint thf mjchirie language ppogram cr^ited with The 
editor, .»H.HblH] wiih Tti. Aii«nibiw*nd Judrd with Thi Lwdar should 
in (MthDTif mdr to Iw HflcutDri. 

Thf LoaOft^win+iMrtprraiptyDUWiin-eAVS?", iihingjf ™ 
woulfl liMe la uv« madiln* Urfguage prDgram. This an be 
particularly iJS*-Ful -For large Fnultiplfl-segiiient pra9r*|RB. Sa™att« 
OTK Urge BPOarim wiU enabl* yoj to re-ioafl ii lllft ^ BASIC 
program with ths usim] LOAD procedur*. An interssting sidt benefit of 
The Loader is that you may use it without loiding any AsBemhler- 
generatflfl ^Md 5sgr?tent«. You m^y ug* only the SAVE *eatire by 
rtspondin^ witti a V" to tte firat 'NAME?- prompt. 

T'ou choDH thi SAVE option, you will alu be prompted *or 
frB liW»nfltugh»MreBSDf ttw.Mqmflnt ynuwish to save. These iruEt 
b»' entiprd in deaaal. It i* unfortunate anomaly of the WC that 
+orc«Mtteuvw* ttl*mgh*tt tddrwi,^qh may be saved « 32747, 
Thit was ppisunably a featira to pratBrt rartridgss from bairq aavM. 
However, it wotKb fine for saving to diskettes. It wnuld be ft giKid 
enprciss in iffidirBtanding 1h* workingfi oMKe ktfftiJ te atienirf ito 
find the limiiing poptum ot the operatmg syatem anr» to -Hnd a wiy 
would it, Th» Ot<odBP would bi yery uh^UI in Budi a pursuit. 

You ii>ay answer -r io -SAVE", jnd 769^ to ' LOW-ADR?" and 
In "Hlffl ADR°, Be aura to have a tape ready to record on, then answer 
^VETttSl- 1D -NAHa?-. -niis will crt ibon 1 file on 

cewwftr for diskttte if you have the disk Virsiort with the na<iie 
■BAVETSST-. Wwn ymj bad it hlriHtiilitis m^i^keitB yo<i n^ust 
key -LOAD EAVSTEST^.l- ftjr it to load .bi^inft ths MitiB you 
saved it4ram. If the file is on cassettt> Just 'LOAD SAVE TEST" will 
do. 

KsKt. The Loadtr will ssk you if yuy wish to "AUTO-SYS'^'' If 
you rtspond The pragrsm jiKt loadefl will B>L«ute via a EYE to 
<J» address specified in the last EQU in tine program. H you wish to 
USt this feature, the last EQU m your program must specify tJie entry 

pointof yoirprogrim. Our pnjBr*B had wch 4n EQU m wt ttn try fow 
to lexeQjte the prDQrini. Key i 't- to the "AUTO-SYS?' prompt. 

Hrwyttihg^iaagoiUMrll, 70U wiU ■»» «w prwki»»f youp 
p™gp4™insItbpr»tiDwaiBplayidiithf Biiddtopfttw^ Wfor 
Hme reason this IB not ttwcaM* it would U gocKtto go bacK to Th* 
adittJT, letri ttw uurce ugmMtt With the menu fiption "L" and verify 
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that 1^ IS cDTE-ect. Hake any necessary changes and re-asseinble and 
rs-lnfld the prcgra,iri. li Ehcuild wiW-k. 

The forinat of the iaaO segment file whith 15 created by The 
Assembler And ciets input by the loader is quite simple. The records 
consist of thre^ p^rord types: address records, machine UnguaciB 

records and in erd-of-file record. Every time The- Assembler processes 
an EQU statement it generates ar address record- Address record* 

ouM The LsAd^r io fflKBt the Addre» of when to ntxt POKE the 

DU'diifte language- The secnHi type of record u a. mat^iine language 
rWBtd, ThBre lb one record for every byte of machine Idnguaor to be 
PfflDBd. A« ndi iTrachirw language ncDrd isprDCtftDDdritisPOKBd into 
sequentially lrcr«4sing (wnory locatlerK until arother adflreisrcciird 
or end of rfile record is enccKinterBd. The end-of-file record is a 
HTiglH V". 



Wwt to put the Bichim Ungiagt prognin 

There An sevtral places whtre machine lang.utg(} programs may 
he designed toreside. ThesB includa i) Inside a BASIC progran 2) 
AftwBASIC SJBeJowBASIC « Inthe cassette M*er.rr33C-»3FB cr 
■Q2B-m^ 51 In expansian RAH in tjlortS^AWWBFfl* or Wia-WlMJ. 
6) Anyplace that The Loader itself does nortnude. 

Irmidt a SASIC pragraB 

To get 1 niacbine language prograin into a BASIC program sn that 
it may be saved with the SAStC program and reloaded right along with 
it, a CDt4>le of techniques may be used. "Pie -first way is to load a 
BAfflC.pRigpui Hveral RS H statementB >^ich tal« space and will 
bf DVtrUtd by the machine language. The toKtn for REM must not b« 
avB-lafal tM VveTT4ring after it cui be . 

ItecDrd th» valuri Dt iDcationc *9-*iS, isyouwillnwd thtin 
later. Than load The Loader into memory starting at some address 
above the BASIC prograin lusing the technique explained in Appendi:< F). 

The Loader and the other fiASlC pragram will both be ui RAK now 
but in different locations. Now rui The Loader to load ttie machine 
language program which was designed to fit in the space which the 
dufnmy REH Btatemervts created. This will causr the RfiKs to be ovrrlaidi 
The best technique is to have the f&H statements at the very frcint of 
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the progrM. TTiii wjy, Ihi michifte langmg* i^Unpl a^^ifted 
■iwri^.v.r)-iim.^4l.mtM.Wt.ddrttoprdfli^tf thi BASIC 

0* your BASIC program ,* you Dv„rl*y mm tttn Dn« PEH, The J»t REM 

«aiement Tuat ba uMd la repUce trts link iQdress of th» fii^ BaM: 
Tt> rfD thuj-ou should kr«w th,. fcrm-t BASIC progran, ir. memf^. 

LOClUCrs 43,44 cuntain the Address at thB ti™t BASIC 
a1*t*™*nt m your progr^^. At thit *ddres*, wil] be i iwo-byl* 
^r>» (rf thQ nest BASIC *Ui.mefrt. Ihi^ t= tht afldr™ 
^" °* ^' P™^'^*" » «gnit«d by - hF« iddrnas o-F 

I-«:FORJ=ITOl8fl»e:I'«reEKa)+256#PEBKa'fl)- 

1 n&w cantijirw ^ idiJfvBB of slaleiwfYl ^xn. 

o™ ^■'W^EtilTOJvlHaagthMtiMnlMdcdwiihTnB Loader it 

*hat thE?*^bBftwT1WLn«<*rW«l«ri.d. Novth.Bt=i. progr.. 
t^ith^!"" 3*ng«^ F».«ng*r and Ih.y may be all m.d 

B» Ciutiorwd Ihit Usiing ihi p^ram may cau« ^i*™ 
chiTictert, mdyb* evtn ciuss the ficrsen to go blink tjr da rther 

h.. ^«;' i=*«"Oiaflriwt,*Wtotni6 5ysl*m. H your program 

J t^fJt."^'**'*""''*' BASIC will get confused ajid inodi^.caticjns 
and SAVElng the BASIC iprogri« wiD cause the lirWage FwnntErt to be 
re *fTEl Will ten* to bbsv Lf) yijur machine iingugage qragpam. 

One +uHtitP tatmon. Th*re ie anothif value which BASIC has 
trouble wtth when wilhini BASIC riiiewTL Tb* v.li» i. Z#4 (*CO , 

'^M»Tt v'^^'^ "'^'^ thi pfoorw WHi MUM 

a.bynTAX error v*ier lifting it The pragr« wiU.m rial tanww* 

And you niy list ttt »uintf«r o4 Iht pr^ram typfr^ -UST M> for 



■Maniple if the syntax Error stopped the listing prior to fitatenent 
31. Thic might Dt cohEid^Ped i sort ai praTeftjon -featLn, as it is 
UKily to contuEe the oppMition Ut J«a«f fcr awhile). 



Another meanc of including the machine language program v/ithin 
Iht BAfiJC progrMi i» to rtn 'Rw U»der, pohing tht machine language 

Irtta Mncry %«hlch Mm tDta ^fflr tlH >d[lrm 

BASIC CO* In your hybrid pnoQFflim. Kdw, ]Md or ffnter tht frograD. 
Kext change the itart-of-veriablec polnitirftat45i44 to point to hob« 
plan- pastthemachintUnguagt, ThiiiHttiod dMf ndt rtquiiv tht 
creatiDn of flEHs and the mjchlne lanugage ncv#p gets printed but it 

flet saved and re-loided with the BASIC prfjgram. The problem is 
that any mndificatione to the BASIC will shift ycKr machirw Unguage 
around. This could be i problem it you Inave- absolute addresiing to 
iP Catt^ within thB proflpam- Alio, BVS* to entry pcrint* mumt be th>n 
dufifltd too. 

The i^Qtr limit of the memory flpac* which BABK belttw* i\ 
hni avalWe for BASIC programs t«naintunKiih«ftifhlra» fietntvr 
at iocatiDns5S,5*. At 52,53 is another pointer which BASIC usee to 
t*t the highest memory jddr#3s usable for string Etorage- BASIC 
Etarta storing string* at Its hiehtti aviilabli rmmopy location and 
w^o^ka backdown. The free memory available in a BASIC program Is the 
tp*C# betwHn the high ara o* variable storage and the botto* of 
■toing storage. It is pcBsible to save mithirw ianguftge program 
Mgnent* in a space which wiU not be molested by BASIC prograns if 
you BOdify tw. two pointtr uft it 52 ,53 and 55 so that they point 
to anaddrEHbtlowthanachlne language* Then BASIC will npt even 
Umw Of M *Kutence of tha.t memory «p4ce and wUl not fry to save 
Anything ihtrt. 



CeuttteBuHfT 

Thm is a EeriM problem with puHing Ihe machine Language 
to the caMft^litj«<rwifli the CMMttf-based version of \rm Mt. 
Th» LoadtF will need Id use the buffer to read the lo^d segmenti> It 
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Ciinna-t therefore POJfE ntchini linguagi into it without leading it u 
thm ift no probl**. 

inwpmUnRAMblDdiS l«A*n-i]^Ff) 

No prctiction 4pDm BJ^Cnud tw implf ruoitttd whan 1h« progriai 
isuplwv. BASICcin'tgattoblDcKS. Tha only froblfii tfiil the 
tAimtlit vtPSiGO B* tht SAVE won't work with prognni ifibtacKS, 

Uhm Tba Lnitar 

When lh» midline Unguagt progrim it not designefl la hive k 
BASIC CDinpDnint the orogpiw may always tit- iD&ded with The Loader and 
w from -Hum. Of The loadsp niy b» ir>CDroc3ra,+ic| into i BASIC 
rro^Mi, In berth Df flieae c«K W itJfcd modules creitiC fiy The 
Asunbler should follow on tha samp 4dp« a« The Loader lor the 
roBiOinttian Loaflef/cthfr BASIC progpamj. 

I-f the loaded machine language program la SAVEd with tfie 
Loader's built in SAVE feature aa dsecribed above it my be tin^ily 
iMdBd direcily with a lonnil "LOAD"- 

A liral note afcautton. The loader takes some space in 
momory. H the spict ypu Wish to load your niichine linguag* pro^nm 
into overUpe tJje space oBTBtjnied by The Loader* loading Wo program 
WlU dfffrDJr Th* Loider; Irf yojp LoajfsP at*? very fitrangs, ihis is 
th« trnbsWifreHph. The soluttpn ip mwUtt carefully where you 
with to load The iowler 90 it won't bv overwritten by the program it 
ii loading. 

CoMvnaittno between BASIC end Juhlni Lai^uftge 

As mentioned, one way of executing the program is through the 
AUTO-SYS opUon of the Loader, To gel tc the machine language tegment 
from 1 BASIC progran invoivei having either » SYS or a USR mslnjctian 
in tfw BASIC program. Executing (rimng^ a nachir* langudge program 
whidi hu rnfiASICEDmpcmentvidmihich has bHnSAVEd with the 
iiption of t^l■tC^ArlHR^f^^»^A^mlui^^flylOADe^iwittl the mrmU LOAD 
*^iHndinvDvntyping*^BDrtlSf»irartr«ton in direct mode. 
Hie formatirftMeySsUtrterttU-EYBeddr', where Iddr U 
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the address of the first statement in the program to be tvecut^d. 
ThiE will cau5r a Jump to specified address. Data iriay be passed 
to the machine Language program by POKKing 1I into some memory 
locations where the machine language program has been programmed to 
finflit. It m*y aifio IM passed dirittly to tfte A-regf X-regi T-reg 
«nd IH^ fay POICing it (UFedly intO; locaitionc 790-783 respQCtiyely. 

The BASIC SvS c0nnarKl aiiton»tiuUyriNdft«^4ourrtB^ vith 

the values found In these locations before peasing corrtrol to your 
machine language program. H al» returns to yoLT BASIC prograin wtth 
73§-7S3 cant^ining the value-s cl ttie above rngistDrc ac your ma.chinc 
language program Istt tham. 

The UEP instrudticm forms* is ■'^=lISR(Ai". This instruction 

11. uaed in pUce of thf SYS when you wish tD pi53 a real variable 
(floating poirrt number whidi contains a fractional component to the 
Hchine Language prograin. Ttu value of Ba3ic varidbLt i* loaded 
into tA« flMtlng point auuoulitor tt 1 {s« chapiter 13 for ■ full 
eifderviiDi?) twforc [Msslngcciatm to the maiJi^ language program. 
L^ heturrangin *he BABCphDgramt the vilus whfch ^ machine 
language program leaves in in the FACil will be assigned to the BASIC 
vtriallle "X^- The address of the entry point of the machinp language 
program must be stored in luaticns I And 2 prior' it executing the USR 
instruction. For eHamplep if the Entry point of the program i? 7£48p 
you must have the fnllawuifl BASIC statement preceeding the USR 
inctmcHon: PO\(g2jm/2Zi: POKE l,7ift9 -PES 

With both the SVS and USH instructtors, the way to return to 
^ BASIC statement immediately following the SYS (H- USR is by the RTS 
Inslnictionin tht madiine language progrdn, 
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Hw HmHor - TTie HomtQi- prnvidts the cipiMllty of punning a miehine 
languagE program t™ irfltr«lUon a1 1 liiPB. As flich iratrurtionlB 
e^etuted, the internal r^gisttrs of thr VIC* 65*2 micpoproce^sop its 
dispJay«-d, including the indivifluil bits of the status register. Thi 
mstmrtian in psecuted is ilsa displayed, bnth in machine ianguage 
and in afiEembly language. The cawbility is w^oviaeO to b/paaa the 
•xecution of any instruction and to dispUy and modi-f/ any mcnacy 
location WhilA in the proceBs tj-f running the prfjaram. The menu of 
choicei ifi di^^j.j'Bd at ■vtiy Htfp of Vm ■x^cgtion. 

FcrthepirpaMfrfdpniDni-lpatlngttiftOiUMftQt Thi Htmiter-, 
you shoulfl have loaded into memory the pS^ram creaiedt aEEombled,. 
loaded and rui in the previous chapters. If The Loader just loaded 
tht niichir* language program "TEST-L" svirything should Be ready to 
go. Otherwise you will need to go back and load it again ^ith the 
Lnctructions in the previnA chapter. 

LiKf with The LoaciEri if youare jsing a VIC *tth ekor Isss 

it will be neces-Hry to modify the TOP-OF -STRINGS and T0P-0F-BA5IC 
poin^trft at 51»52 and !5,5i belore loading The Honitor. See the 
p^Vious chapter fop infornation^ If the pmnterH hav* not httu 
re*tcr#d lincs the prei^ioufi modification of these polntm it wUl not 
bpnecKearytadDitagain, ^ iuhIoMUk tfiiAK^n^progrubE 
which are loaded withoui reietfing these poinlira mky ^rtS ihenielves 
"OUT-OF-MEHOPV" because of the change. 

Loading Tf\i Montiop is by the ume process is with all prcor'ans 
in the Kit. The name of the program on the distribution media is 
'MONITOR". It nay sometimss be necessary to load The Monitor into some 
part of memory other than where BASIC program* normilly load. If the 
pro^aB you wish to monitor is in the normal BASIC space you ffiay want 
to loai^ ii into some other ds per instructicins in Appemdu J. 

For the purpose of this tutorial^ The Monitor nay be Loaded in 
the lJBLUlepu:«witftoul:Dodifyinathe^nt«rs. Dnceit^ Loaided, 
Key-RUH". Thunefiu ihrOO ippeir- 

"S" IS the fn*nu option to (S)flt the addr&sa af the ntai 
instruction to be executed. It w<iU be -Followed by the "ADR'' prompt, 
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asMing iht starting addrtts. Valid replys are dedmal numbers in 
the nngeof 4-6f9^ andhekiaidB^alflMBbepfiln^ranse of *#W*- 

-H- Thi Mad«3r iTrtw ihi CHlMoiy dli^^/n^fy «*fid». 

ttiiB is aha ^OW«d b/tht "ADR' pronptt requtsbng tUrtinq 
address ot veiwing/modifying. 

"E" will cauH the instruction about to be eii:ecutEd to be 
IB>ypaHed. Rather than execute the displayed insiruction, the 
instTLKtiiQn bellowing the displayed am will be displayeii- 

Kltting [R] with no nenu scltction will cauu th« currtnt 
inatructiDn to be e>:ecuted end ttie next instruction in the program 
flow to bi displayed. 

Key a "B" to uine single stepping and amvw the "AIW prompt 
^^TiKf tihetddrc»(if the>ntr7pinn4Df ihe progru The first 
in^trUcticii of Ur program flhotflti nbv appiear Off the men. 

Afl eatti instruction n about to Qt eiEerulaa, it is diEplayfld 
in both machine language and in assembly language- The status 
re^ster is broken into its individual bits <H = negatLvet V " 
overflowi B = br*aKmod&i D ^ Decimal mode, 2 - lerc, 1 = intPrrupte 
inhibited, C = carry). The other registers displayed are the A-regt 
the X-reg, the Y-reg. and the Stack Pointer (SPJ, Upon execution ot 
eac;h instructiDnv tharagiiterfl ar« loaded fnm Vvse lave anat in 
nwmory- 

X-251 A-253 P-M4 

If you wiih to modify or pre-initialize any of the registers 
a.1 any time you nnji do so by entering the Henory-MniJify mo^ «n4 
modifying the above lou-tiona. 

A "software " stack is substituted for the hardware stacK in 
page 1. Its raa*imum depth ispre-set at2fl hytes. While this will 
l>t»#ffiWinl for the vast ma^prity ol yoLrtistirtgi you may increase 
itlfiw«rflsary by sotting tfie new naximum litfith Inthe SD variable in 
JrtM»rBenrt 1- If. while singW-steppir^ through some proQramp you 
*WJW Mitutfl « fiTB Dr*PLAor!V withatrt f^t having [snhed 
Hnttiing onto the sCacKHwith a JSH or PHA or FhD>, asUcK inJerflow 
will uor. A TEinstftctionsetiing^BPto^miie duHif-ranQe 



IrsUtTTw VIC 



Pigtt-S 



vAkJ« will Also cause 'sta.c'' LiTdeHlow- Overflows ar* cauHd by 

rtpBtitive PHA'sPKP'soriJSR'5WLthoutCDrrf5{Bn0ir>9PLA'fi PIP'S or 
RT&'9 urtil tti« mdhifTLLim stack depth his been e^ceedec}- In the event 
□t undprfltms anb over -flows, a-BTKEHR" iriBGuga will b^ displayed, 

EiKution may mr-tinue if desired bu^ reEultfi an Itlttly to be 
ireitpected if your fflonifarKi pr&jpimis. expecting to find Mma 
significant information in ihe e-tacU (HKs a r«Wt) addrfbs). 

Certair machine language programs are written to modifj" the 
Stach directly by storing data in the high pnd d-F page Executing 

^ese in^tnvt^HVi^ with The Honilar will rut cauae the desired etacU 

nodiftcation eHect. In +actf it 15 ipnie lii(ety thai The Honilor 
will actually crash upon the evecutiori c-f such instructions. Since 
The Hoffllnr i5. written partially in EASJCi- anv in-^truc-tinn^ u^hich 
modify the BASIC vectors or other in-Furffiaticai vital to the running of 
BASIC programs may cause unwanted result^^ 

As The Monitor single sleps through & mdschjne language 
pTDQTani it clwcKs each op-cpde oncounta^d ^ vali^ity^ If an 
invalid cp-code is encHjtterd, -thi messige'OP'COllE = nkt*' (where kkx 
ii the encountEretf op-cotfe) a-pppar wtiers ths mrEmonic would 
otherwiu appear. The Monitor will rot try to exetute invalid op- 
codes. Nor willit try tn B*!ecuto BRKnr RTI instrtjrtie™. Allcit 
these will be iiftamaticBlly bypas^d. 

H ybj have treated and loaded the sample prograiR and tiave 
loaded and run The MDnitor- and have selected menu option S and titv* 
answered 7608 to the address prompt, yoj will now see on the screen 
the a^Mrnbly langiMQe statemfrnt "LDY #8" fcillow^d by a line with thB 
address 7608 and the nuhine language eqidvalenl at ttieataQv»as»n^ 
Unguage itatenent: 

FoUowing tiie ni£hjnft laOQut^jt -Mil be the display of the 
regi»ieriprior -to tiie esectitiontrf the displayed instruction. They 
will have no particular sjgni^icancB at this point becajse they were 
nevtr inltiili»(}. Nol*, howeveri th* viltir of ttiP V-reg becouia 
after eieecuting the instruction it shoulef tftange. The Zero flaB, if 
it is a one now should also rhange as a result Of the ekecution of ^e 
instructiDn. To execute thp instruction, hit return. Do that now. 

If all is well, the next instruction o4 the sample proflr*in 
will be diEplay«d and the firit initructitKi will htve l»<n vxtcuM. 
Vdu may veri^ -Hiat br ^lecUng ttw Y-reg. li-choidd bt of valw B 
now. The WTO bit shoifidb* a •because tfcertwdto* faHiinflltM ¥- 
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reg ii not zefo. Note the diiatienblid stateneni i% not Identicil in 
-the aes^eMjrUnguagettatflBmt we wrote. It ieequv^tent bvt not 
identLal. We wniti the atateirient: LDA«?*22+4.. iTii diiplayed 

AWwwrt^iBiddbv: LDA*»2. TMimvewiMyecEin-beuveTlte 

Hnliar antWk what WMittifrta Ttie AiiemUar, only Utii.t une out 
Arid it doe* the beet St can in reconstructing 1 valid ac-HRd^ 
linguiQB statertunt ffov the me.dtine Itrguage it hai to unrK with. II 
generates all operand field valuer «s a simple decimal value. Utien 
this infltnxtlon le executed we should He the A-reg's value reflect 
the LDA operition. Note alia ^at ths number 242 ie greater than 177 
and,^ as sudi, the high-order bit ic on. Consiquentlyi the Negative 
41ag should be turned or by the execution of this infitrueticm. Hit 
[R] indue* 

The next inetruction which ts now ui for ntecution will itore 
iHw A-ret) ^if^louMDn Hffw tihe atatuefUgi an ^cUd by 
^ Mtrtctlcntoin eh£UldHtfrtoChifpgiVpf1l^WlK^ DO 
it. 

Thii would be a good timi to looM it the HemDry mipUy/Modi^ 
mode. Ratlwr than tit [H] 4t this timep Key -H [R]'. You ere now In 
-ttieX-nde. 

Upon entering Memory mode, the address where you left off in 
single-atapping will be saved and tKe "ADR" proinpt will be displayed. 
Ydu may inter the finrt addrew you wish to examine op mMify. The 
addr«n my be in the range t-£S?35 or >0eeft->FFFF. The value of the 
date Vtii^ ftttiierfQuMteidaiidreHVJ^tiifdispl&yed.indlhe pneipt 
"VAL^- >iill 4pp#V. You may da mt Of thre* thi You may eiit fi» 
HeiHry node by Keying 'XT. You mey modify the displayed location by 
Keying e value in the range or tH-tFF. You may continje 
viewing the nent sequential memory locations by hittng LRJ^ 

To lonk at location 8, key a "8 [RJ". The idflrv^s ^6) willde 
dispUvfd tollDwed ay ihr contents of the specified location. In this 
case It should be 202 because that is the value we just stored there. 

FoUowing the informatiDn line will be the question "VAL?". 

Tou^ mvf now change the contffitg of iDcatiin % ii you wish by 
Hiying sane fwwvelue- Th« n*xt loca^ wiU now be dis(U4y»d, 
iBenrytocat^i- Mdftlti cOrrtentsandiBOe&fyiheiiii* youinsh. 
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To iat son through mpm-Dry^ siirply continue Id hil [R] ^ach 
Ham iviJueiadiBpliyed. Whan you wish Iqrtium to tha iminMnui 
Hay "ir for Hit. Onw this hi* beffn donfit the SMB menu sftould 

1/ yotj Fnodified locatiDn -8 you shouJd now re-en^tr H-intrifl by 
entering iris '^M" option, *nd aaQrftKS S again. UPhen the vdlue you 
ttUcK infl IS dispJayBd, chmgeit bacKlD 2*2, hit tflj, and when 
iDCitim 1 ift ijLsplflyedj hit 'X* to gtt out igiin. 

itow torwtoilo thepTDflram we ^rt^e single-6tftppjr>g through, 
slnpty hit CR]- We ctjulli tlive startgfl fiinale-attpping it iny locatim 
wintrt to by sntering option "ff" v)d tht.ntw uklrBs» wfwre w 
wanted ic go to. 

Thf rmuX insTructlon in iht program is now di^plivtd. It as i 

LDA ifiBtructian. Note the registers still hive the 5a.me mnlerrtfi as 
bffoffl the H-mode eKcursicn. The A-reij will now tie loaded from 
iQcaticn 6A&. Location i49 contiins Ihe DptrjTing systam's 
infarinatiDn about which (uge of memary the TV scrssTi's data is Kept 
in^ Irfhin putting data into the green's memory ^pszs, it wiU 
*utoBali«ll/ app«arontiieECreenof yo^TV, Hore ibout this in 

This ff^im it setting up 1 vertoT in iKitiianB ft and i 
Hrapag«toa[IeiroBstheMhajaurnnp*tbt^tt3Ji:»eDfthe.Kr*^ A 
loqD in the program wiU fiaqueMially mow tf«rirt»rB ft^m a data Ana 
in the pTDgram (MSG) to the sireen merropy where they will unear on 
the TV. ^ 

Hit Cn] and see the neKt instructlDn which is a Store of the 
A-rrg to location 1. Hit[R]aga:nj The neit instruction is ths 
beginning o-f a loop. It loads the A-r»g with tht character at address 
7595 tilui the contents of thp V-reg. The V-reo should stilJ have the 
vilue of 8 to th« addrtsB wtiert data is being picked up from is 7599 t 
8 □r74t7. liamt&K-nudvandseBWhAtwtiwre. It sAouU b* tb« 
ASCai VihM Of ths lettw B, OC 93. This is the Ust diaF*ct«- in liSfi 
in the mgina] issemblj* l«nguagi pi^#i?i. 

Go bach to the program now b^ eJtlting antfreflpOKtLflg to H* 
menu with d [Rl. The instpuction wjll be e»reciJtfd. The A-ng Bhould 
have the value 33 and the AND instruction js up now. Its ftjictum is 
to cmwrt the chK-acter in the A-^^ from ASai to VIC so^en formal. 
The scpffn fi3rin*lfor«ie lttt»pa A-IAtve thei-bit o« uMlt the 



ASai Ehvacters haw it aru TTm AHD oi tfa* A-rag wi^ thf heic value 
tSF will afcamplish that. Gee Appendix D d4 The l¥oqnmnBrs Rvftwu 
Guide for more infortnatiDn. 

EKecute ttw Instructian and notice vhat happens ta the A-reg. 
It now has the vslue trf 19. The &-bit has a bit vaiui of &A and 
tLrnlng it off should reduce the value o4 the A-ng by 64. Uhidn it 
did. The next instruction to be iJiecuttd wlU store this valui it the 
iDUtipn tM(]uMf[iuithE9unirf#ieantiffitADf^ Y^rag ml the 
uldnnsvectorirclaationstafVLl. H>wt4Hi IhtivtliM tt^iMdat 
locattm 1 Miii^i* Ilia page < ii4 sown intmDi73Uk'im^^)^ it by 
ZU ■ndadd-theviJues^dlnlocit&onlS«erT^2*4>t yo^^ 
g«t the base address to i^idi the Y-rcg is added. All vectors worM 
tb>e sane wiy^ add the contents ai the first byit of the vettor to 25£ 
times the second by^a to get the JddrfSS being rtferencPdr 

After axenjting this instpocticn with The Monitor, it may 
artuAlly be difficUt to find the value where Ihi program juEt put it. 
This is because the scresn meniory is modified by every program which 
writes anything on ths screen. The KonLtor writes quite a bit to the 
KTftfW wa ^ strm MRtDPy is tlttred stiait n famt h out little 
pmpui can put wmtldng there. TTllsis one of the ifrfor^Aaite facts 

life in debugging programs. If we Know in aiivam,tDeKp«t -ttiis 
Kind oi problem vre may not end up quits » ctmfuseit when it h^^ms. 

flitecute the nent instruttiDn, the DSY. The ¥-reg should now 
havB the value of 7. Uhat is the contents of the Z-flag? It should 
be zero bccaiiM the DEY Bid nut cauMi result of iiro. S«etute the 
ne>:t anstruction. The BtiE test^ the Z-flag. It branches if the Z- 
iUq is nD^aonfl. Itlsrot^ so the branch should -takr place. 
Bcfors snacuting the 6NE| check the address af ^h? machine langui>gs 
instruction* Now E)cecLJtB the BNB. The new address of the machine 
IwigiH^^tnjctiDniflltinu In ftd^ the rwwinBti>i£tiai r«ddy to 
b>tit<cut«ljs1fwlJ)AbaaEt|>«f^«tDpaf the loop. The brarvhvss 
tslton. 

It would be good rowtottep thrnu^ th« loop quiddy, 
watching the Y-rog get smaller and smaller each time through. Whin it 
gets to one, -watch what happens at the KY. The Zero-flag should go 
frpni 4 to i when the Y-r»g goes from 1 to ft. The HKE HiPn should not 
take the branch. The address of the instruction up after the BNE 
should be two greater tfain the address of the BNE itself. At this 
ftmt, all eight bytes at KSQ will hive bf*n copiiit iMo ICTten iseplry 
(mly to be Dbliterated by The Hordtor). 
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this program rin by the LoadcTr Uib (nu^llnv luouAgfl 
program had corrtrDl ^or the tntirs fiin# the chairactn^ wtr* 
topiftd tc "ThB icrein. The Lniettr did m It^rth^r activity hi yzu 
wsrv 4ble io th'in ip^ar on your screen -thm ind ncit now. 
The Issi mstryction in ihe program is the HTS. This is the 
a program enttred a BASIC SYS re+i4rn5 to BASiCi If V^LBtUt-Vd 
nowr ii mil try to return (hPDijgn a stack which floes nnt have iny 
refLjTTi ifldreES to retLrn thrrvugh. The Moni*QP waww yau thai (his h«H 
happened. Tr^ pairing it and ^ee. 

Ronltcr it i vtry powerful taol faf both dAbug^ng And fop 
iQAming how-trie in.3triJc4iDn ^t wurHfi. You [:ari uuit ta Einfl^'^ti^ 
any mafhinfi Janguage progr-arh ^nclubing ttie BASIC D^Mratinfr S^'tVin* 
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T\-im Tools — IV 

Tlw DflCDdir Th* opposite of Thi Assemblerr The Decoder turns machine 
language bacX Into aE»mb1y language. The format of the assembly 
linguagt program is idfntiul to that which The AsKoibler and The 
Sdltor accept as input. The Decodef proOucts t^t progran Listing Id 
«ie screen, optionaUy to the prtnter and* aJso optlDfiaUyi to either 
the UHtttc or thv EH«tottt depending on the veriian of the 
bt vvlcKiiMni Kit you have. 

The Decoder produces dl iddresi and ooerond fields ifi 
deamal. It doc3 not producf libela. The imgrin created by The 
Decoder will reeemble the original aiumbly languaf^e progrin- which 
creaied the machine langutge but it will not be identicals This is 
flue in part to the l4ckDf label generaticxi. It is also due to ttie 
great flexibility available to the assembly language prDgrammcr in 
■pecifying addPKB eyprecuone. The Deroder can't ttuw whit the 
original eiiprewlen was. It only sees the end result, which is an 
addrvee or imm*di*.te data value in binary. It converti all euch 
information tQ t tinplf dednil value. 

1^ l3e[oder is loaited and rifiln tt» umemafineraslht iVther 
tool*. The name of the progran on the magnetic media is D&CCHKRp The 
DecDderi liltt The Honitor and The Loader may be loaded into any 
available AM- The first prompt you receive when you run Tha 

Decoder is -"HA)!?". This prompt is atWnj for the maximum segment 
fiiie ynu might wish tg ^reitff tv eventual input to TTie Editor or The 
AsKmbler- If you have no intention of uaing 'nie Decoder for this 
pLTpoae, you may hi* [R]. I* ynodc cwife a fltgjWPrt oncassete or 
disKctte to be assembled and/or nioOitied by Th» SditOr and The 
Assembler! respond with the may unufn number of assembly language 
Ktatenint& you wjsh to automatically ir«al» with TF» Decoder. H ^ou 
■elect Oie option to create an output fiXet the program will 
automai^aUy stop decoding uponrBKhina the entered BaniiiuHD yalue' 

ThB nnrt ppom(rti ■PHlNTOirfTi allowi you the option o4 
creating printed otrtput. If you reply with a "Y" you will 
automatically receive a printed listing of tha decoded program on your 
VlC-1515 printer iDT equivalent). Any other reiponse including just 

CRl will suppress printing. 

Neiiti you are asked i-F you want to create an output file. It 
fou answer "Y^ 11 will cause a copy of the decoded A&»Fnbly tej^t to be 
tortonaticaUy SAVEd to distatte or caisette in the special format 
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required by The AswnblBr and The Editor, Any crthep refipons* will 
Buppre« SAVEing. If yoii do -so diDOBSi you will bw proratf ed for the 
"NAME?" ihe segment to be saved, Yqm may respond with the mua] 
legal fUe nairiDS orp in the c&ae o-F cdSHttep no nime. In the ciu of 
the diilttttvi if you Itty a nAmv ilreidy in CKiatenct on Xfm diWitr, 
TTi* Dicoder mil r>BpU<t tti« old verEion Mth the raw. 

Yiiu mufi-t iell The Decoder where to hegln decoding by ^nswiring 
the "^TART ADDR?" prompt with either a decimal number in the range of 
e-d??^; or A hen number in tha range -«FFFF. 
If VDU respond hy hittinn CR] without any entBred valia, Th* □•cndep 
will begin decoding it the addreaa where it le-ft oH. I-f this i3 the 
first decoding you loaded the program ■ hitting just CRl will 

tauw it to slart at addrp^.^ ft. 

You must tell The Dicoder where to ceise d^coiltng by ynur 
re^ons^ to 'SUD ADDR?". Your reEponsB may either be an address or a 
Epen-^LC op-Lode. I-f y-ou specify an addr»s»i it mLKt bt in tha range 
of ■"£5935 or tMAt^FFFF. 14 you specify in op-coda you mist preceeii 
^e OfV-codf with an ''A'. The Dp-codi may be sped^d in cltiVP 
dedrhjU or htK r»" pMCtrtipg ttw op-code anQ after ihv "r). 
Spedfying an op-code will CiuM The Decoder to check eadi op-code as 
it decades 4he machine language and to stop decoding aft^rthe first 
DtnrrAn^? gf tb? ^pecdf ied ap-cods. Hitting simply CRD will cause 
the mo«t recently Entered response (either op-cDde or addr«i^) to thic 
prompt ta rarrun t^B active fitoppi^ liEinkl. In other wardSi if you 
decode several subrctutines you only have to ^ive the #t£fl respcnt* 
once the first time* hitting CR] the followinQ times. 

The tirct ctitenent ootput will always be an EGU statement 
which wiU h«vc as its opir-wi the dedm^ value of the Stvi AddrcH* 
Each elaiemeir^ avit is ^eneratedt will display the decimal value of 
-Unadc^natMAiuhttwElw^HJinitructiDnrtsiAeBin mamory^ The 
address will be followed by the mnemonic tsudi ai JSR or BME), 
ff^Jownl by the Dperard field. If an invaJld op-cole is encoiaitered 
by The Decoder where it it eKpicting to find an » valid £5ff2 op-code, 
a BYT instruction will be generated having the decimal value of the 
encountered b^te as its operand. 

The operand field will indicate the addressing mode with ^ 
following conventions; as thefirst character of the field 
Irtditate* IfliMdiate rtiOd*P will preceed tha operand fi»ld Df 
leTD pafteaddreMing^ridZPtXandlFjY. Addresses en rl n wd in LJ 
ara desigrutKd ^iiUract ad^kinuU^ Badee. Tla sul^ea of iX tfid »T 



imply u-ide>:ed by reg-V and reg-Y respectively. All address values »rv 
evpre^sec^ m detimilp 

After t^e Decoder reaches the [fisignated end of the segmentp 
wtiether by hitting the HAX value in ti» case of a. SAVB, «r by reachinct 
tha riigh address or by encountering the epedfied itopping op-codBf 
TtM DecoderwiUretiLm4athepr«ptfv'miK70U7?\ Youmay now 
dtCOtft im&W- «ae1ion ^ Wtmtxy, selecting uwW ^ opticm 
(PRIHTOUT, SAVE, START ADR, END ADRl 

Decoding cartridges is not a prcibleiD unless the cartridge Is 
an autu-^lart [artrid^e- Then it is generally neccssiry to hava a 
h^rdwarp aui^t. Many expansion chassis came with a set of switches 
which enable and disable the various slots on the cartridge. With 
this feiturei the iuta-start cartridge may ist Affectively deccided. It 

is necessary to have the cartridge ma awitthable slot of the 
eMparuion chassis with the slot disabled when the power-on or reset 
proceas ocQTs. Once that h&3 h«ppenedr iho slat muet Da enabled by 
throsiring the switch. Now the cartridge is in Hie aiMressafale apica 
and you still have contrdl of kemachine. toadThe EJecoder and 
specify address %AM as the starting address and decode away. 

To decode cassette or diskette based programs which start upon 
Jcuding, it » necesury to have a reset button. Host good e>[pinsion 
chassis also have one of these. Load the program, hit the reset, load 
The Decoder into snme space not used by the aulo-starf program, and 
decode. The reset function will destroy i few bytes Eif dati at the 
START-05-BAS1C. If you have in expansion chassis and same expansion 
RAM, it is possible to change the ETAPT-0F-BA3IC by switching Ihe 
fxpamion HAH either on or off, Iflth exparaioni the start adbreM 
BABlCis4£ft9. With no expansion, the address is 



The Decoder is a powerful learning tool . With it you nay see 
how other well written programs 60 what they do. The cmjlno 
techniques of others can become uxorporatefl in your mm big of 
tricks. They will provide you a valuable base tcr building yoia* 
sKills inventor,'. It fan Be particularly h*lf?ful to eKamir* the 
operating system to more fully understand ho^ the VIC was designed an! 

hc3w itsintenul *eatire« are utJllied by 1he systems prograBBw^wtiD 
wrote BMJC 
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Ubtlm 

Thf lafcwl fieirif it usm. is Ih* 4irs^ hela tha as»m(Hy 
s-tatement. It at not a requirpd Ifuaed, it "»iist start wilh a 

ietier iA-li and may £te of any length. The sir>gle chiracitr "A" 

Dhoulil not uudj H il will be confused wilh We "A" -the 
AtCumjlafor uWrMiing tnodt wftan appeirmg in an opepind fiejfl, oth^r 
cbaractera wWch flJWuld Iw avoMed tha seven aiaebraic npepatdrs 
«nd the quDti n, Labilfi of mbw fliWi few chWiriwit will cause ihs 
assembly listing to bs somewhat iswneit i^iPaTg but vo* just 
ftne. The longer your labels aref hmv«v#^i the Ikb atatsBarrti that 
can ^it into i fiejjnient. 

Standard mnewmici 

The iwftnwiic i» tht Enjliati-lii* code wtiich get* translated by 
T^ae AsSembET intc) the madiirw language op-cniJe. A fliBcyssion o+ the 
mmmanitB is ftxrtJ in chapter 5.^00 apptrdi« A to-a complete list of 
all valid mrtcmonicE and their legal addreaaing modB&i 

TlH BQU piiudo-op 

The Assembler cDine 5 equipped with two special mnefnorucsp EQU 
and eVT, These dfl not generate processor-B^ecu table inelructiDna as 
do the standard mnernoriicB. The BYT psaubD-op is Lovered in the rw*t 
pU'adraph- the fiflU mnPmonic is an instruction to The Assembler rather 
ffianUiin^fructiwitp the mathiw, It has two tiincljcxisr ThB+irst 
la to.settl»lcxatlDncttfi^r. Thisis a tiinctiDn sometlaes lett to 
i Mpar'ite pi*Udfr-E|J.fitiCfi as OHGiH other assemblerE. Ih. ucvd 
fuTclion is to equate a label with an addreaa. ^ha tEff-nat pf the EOLJ 
instruction ia: 

LABEL EQU adrir-ex press ion 

Thi liM field is optional. There is ons exarptsfin to the 



gerwra] rules for address Bxpresslnrrt for the EQU instruction. The 
eHpre-sslan nay not rflf orBOCfl labeU whirti do not precede the HQ.U 
instrijclior in the segment. This is true only for the EQU inslruction 
and ia the only limitation, on it. Any program refcrerbces to the label 
□n the EQU instruction wiD refer to the address t^ppeeMd in the 
DCMrand field. 

The last EOU In aaetof some segments generates load 
BftgMnt CDde«t>tchl^eLDac|erJnterpretbi9lbeent7 addr«B£)f the 
pTDQreit. th« Loader vritl tan if rDUWilh to Atrn^^S? ettheentfOf 
loading Itaad wgflients- !f you answer 'Y'l it will SYS the addreH 

»Kpr»seri in lhi& EQII. 



Hm BTT p»tido-op 

The BVT inElruttiDf^, inlii* tht EQU inatrirftion, does cause 
machine language c&de to be generated b/ TTie Assembler. It is not 
generally used to generate B]<«cirtab]e code liW the standard 
wwrnonicfi- Its ftjittion U tc provide 1 means of cauunQ fiati to he 
■toreii Inftiemory. Therlsrt* genff'ated liy the BVT iratructinnTTrty be 
spedfted in several ways. Depending on the first chfi'aLcT■^ of *e 
operand f iEldi the BYT instruclion nny ipedfy henatSffSmal itnngL 
ASCII Htrings or iddress constants or single by te values oi hen, 
decimal I* ASai. 

HnadedBal strings 

If the first Diaracter of the operanrl field is then a htx 
string will be geiterated, Ali characters -FollDwing the "S" ahould be 
tien digjtcj 1-9 A-F- Thsw »»y be any numbtf o* sLich digits, Th» 
Auei^Ier wiU create one bi'te of data fof each pair of digits. If 
there are an odd number of digits. The Assembler will append 1 on 
theleftof thsstring- 

LHwaltmtmtrlnas 

If the +irsl character of the operand field is a " ' ", all 
+ollowing characters will be Translated to the Commodore ASCII value 
of th» tharactifs. Each tewt tharacter in the DDcrand will generate 
one byte of data. Ail the characters which nay be entered -from the 
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keyboard with tfie e^ceptlOfl o-f Ihe quote <, " i are legaJ. The HYT 
hXsnl instruction is th« on^y instruction v^hich nannot have a 
CGmnent field. CDinmenta v^Ld be interpreted as part o+ the literal 

A "11° irt the first pos-ition of thB Gperand 4uid cauHs tlie 
expre9%lon whidi fDllows to be evaluated by the rule^ Q-f address 
G»pfvssiDn eviluAtion, The single byts which is genrntDc} ^ Low- 
ordcr ttyte af tha rflsultant twa-byte eyaluatiDn. 

AddriH nmttntH 

X* th# *iP5t <har-actpr of the opBrand does not mtt\ any 
the above criteria then theoprrandui evftlu%t«d is tddress 
expreSBiai at 6tftr»6 itter^. Th* tWDbytes oi datd which tr^ 
ganeratsd fire iii the lUfl? addrsu iDriDatc with the low-Crder byti 
preceding the high-order byt?. It should be not^d that a BYT 
instruction uch as: 



BVT »3CC 

will not 9erter4,te ^ri addr^s^ crjnatant in th^ iDwHiigh format- 
It is a hei:string an^ wiLl generate 63 CC. To get an address constJint 
it wjould be required to write sn iffttPUCtian SLrch as- 

which VDuld generate CC 93i as expected. 

The folWing will also gerwrata the same iddrBss expressioei; 

HSGEOU OCC 



The opvrind field 

The m^a^d field foilows innhediatelr 4w ninenKnc AeU 



and specifies to The Asunblvr the address of the bata to be accessed 
and the niodg by whrcFi It will be idEtresssd. l^^n are actually 19 
diEtincl addressing modes by which the location of data is specified. 
The for mat of tl>e operand field [Tatermlnes which mode will be used and 
therefOTi exactly which op-rodi will be g»n»ra1ed ind how many hytes 
of addreBsdatawfUtie generated. Hot all imtructiDns may use the 
sue sft trf addTHsing oiodes. ApperHJiji A specifies the valid 
AiHrfra^ Qwdes fer HCh inslructiiin IT ntfWflioni^ 

Addrass exTns^dns 

a* of the great strengiJis of this assembler is the ability to 
create address eiiprK^ons □* great conpleiiity Cor simplicity^ with 
ease and flexibility. The term 'address eKprtnion" is msAnt to 
jnciude ttie "immediate" character and BYT data constants as well as 
actual me mory locations. 

There ars five dl«epent kinds off te^ws which may b* 
algabraicly ctjmbinad fii an address Bapreasion. Each has its own 
dtstinguiflhing format to identify it, 

DtdulfCratt 

Any tprm in an address expression which begins with 9-9 or a 
".' Will be interpreted la a deaftal term. DeciftU terais may be 
inteflers or may tontain a decimal point and a fractional tonpofiFTt. 
There iS no practical upper or lower limit to thetr magnitude. 



Heiadeciul ftrnat 

Hexadecimal terms are those which have a as flw firat 
character. All following characterSf Lip till th* nwrtoperiW or fte 
end of the e>ipression, be A-F, 

Li-tiral tDrnat 



Any ter* in an address eKpression which begins with the 
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chiractar" will ht in+Brprsltd ds a literal. Thai i^, th* value 
Aoaigrwd io that tsriFi vm the ASCII vdlus cjt the first cti*pacter 
to raght of th» " "* .. Any chirdtterB following the first 
diVftClBr fbUcwing th« quoti will b« igmnd. 

SyvbDlic labtl 

Any tsriB i^hich d«t not start with a "t" or a or a "fl" gf 
a " or 1 number will bt intBrpreled as i aymbnlic label. The 
AfliSemtlcp will warch thp tntire program looking -fDri mat^ on 1#» 
l^el field. If nonff is found, ERR 3 will b» generated. 1* a match 
ii 4ajvi, the term wUl ibe a»iened the valu* of the addresm 

uwadttHt with ^ taiwi. Libtls nay be of iny length* 
l^tiiunoMntor 

The locatiqr counter is The Asunblr^* equlvAlHit Of the 
ptograiH muntvr. The locitlDn countw has th^ valufe bf ^ curvrrt 
acWres* aaaigned to the -first byte of an inatrtrtiDn, H a tht 
iddrPSB at which the instrLJctuDn will r^BiiJe once Thi Load#r POKSS the 
load segmont into mBinciry. This iSMmbltPUMt "O" symbol to 
signify the location counter. Moat other aaEemblera use the ' 
symbol -Fcr this function. However, the "*'' is interpreted by The 
AfiKnblvr ai a mjltiphcatiGn appratjx. The'*?' symbol se-em a 
looicil choicei being ths "af sign and signifying where we ire "at" 
inrwoery. Any terdi which haa-'-fl" as tis first character will h»« the 

value at thvioHtioncDUttBr* faUowbij Glwvcterswlthin the 
term, should they rxisti wUlbe igndreri- 

Algtbreic ofwitor* 

The var'injs tvrin-% 0^ the address eitpreision nay be combined 
algebraicly by the following Dpirator*: t-e/^lK. As the 
evaluitior proceeds from left to right, each tern is added to» 
subtracted trom, mulhpliEd by , fftr. the rcBult of the tvaluationfff 
that portion of th# enprtssion to tiie left of the operator, giving a 
new cirrent evaluation. The fractional portion of the result of any 
Cfwration ym be carried into the next operation. The final 
■v«lu4tlff) of ^ «Jipm«an waQ truncat* «ny frActional coMponvtle 
■nd yOl tsnVert'ntgitiveruHbeM^lfTfaaSixteMiU.i'M^ raaptoMlA 



values. 
Adittinn" + " 

The aOdilion DptPitor MUiM the terei Immediitily follDwing 
the ■♦'to be added tn the refltglt Of the evaluatlnn of tha portion of 
the enpression to the lefi of the**^. 

Bublnclipn- 

Tht »il1r«ticjnop»patarcBUKDthTtwntiQtfterightDf the 
i^na 4ign to be subtracted from the ei:pre«ion to the left of the 
■iru. 

The cnultipltcation operator cauaes iht eHpT^islDn tO the l»ft 
of the " * " to be multiplied by the term to the right of the « " . 

iHviidon-/- 

The bivivior nperatx caustE thi ej^pression to the Itft of 
the ' / '* to be divided by the term to the riflhl of the " / 

BxpflTtntJftion- 

The power operator ciuen the Bvpression to the left of tht ' 
" ■ to be raiud ^o the power of the -term to the right of the ' " 
Fractional powers may be employed with decintl terois. It i»tbereftire 
Dumie tDriosudt thincaattaKasqiiare nxTtswithcjippetfloni udt 

as: 

Logical AND - 1 '• 

The logical AND operator the result of the evaluation 

of the expression to the left of the totie logically ANDed with 
the term to the right of the . The logical AKS operation compares 
ttw two terms of the operdtinn bit by bitr giving a result with a tilt 
set on in every bit positLon where bath terms have a bit on. Its main 



Lr» ii 4o ^arct bits oft in cerlair iJpcired bit ptM^tiDmr wtiil^ 
ratiining t^e status Qua in all oiher po^itjans. 

flotJi lha AND and the Ofl inslr^jction have & restriction on ihf 
range of the vahje a4 t)o*h tfie enpreaaion to t^i* la*t the operitiw 
and*ht*Brfltto«»eiiMo* *hnip«'atcir. Ti«i4*wr it greater than 

TTw A»tiiriilws-rfll*tafiwittianU.LBOALQUAIlTlTYEPROB. This 
rneanE tliat tht rang* of aMress ixpm>ii7n>«»id)inar beqfpraM i^ran 
by tiwM operAtiirs must be If H ^fen I^W. "liiiBmlriistktngccUPB 
btc4i;»e ot ihe way ihe AND and Ofl oprnttons «r* hmdltd h/ tf* WiL 
It is pos-siblE to furUaliy drfett this r««triEtiDn. By spKifyinb an 

thi value ot X nay be in the rar>ge of ta d5?3£ <164ftA - trPFF}. 
V muslstiU.i»inthtpa.ngto(frto327t7. This i'Multa in AHDing 

327^7. t^Tflra is rupravisio5 40rtiucaufuUv AHDing crOTU^ 
valuflfi nanirfdi4is»pf^k«cti. RwnBibtrlhitjiT - md JSV = 

The logical OR operator tsLrees the result □* the evaluation of 

the wprsisiDn to thi left the "S" to be logically OR'pd with the 
temr to the right ot the . The loflicfll OP operatior compare* the 
two ierms of the operaticr bit by bitf giving a result with a bit set 
on in evtry bit positim whare titter term haa ■ bit on. Its main \m 
n to for» a bit on in certain 4esirad bit positiDnsi while retaining 
the Status quo in ill trBwrpBMtiqns, Swthe pr<vidiiJH aection for a 
diKriptian Eif limftatiDn^ unn ttwuw af this instructiDni 

KKpnwltfi evaluatiDn 

As hiB been indicated in previous sectionsi several terms -niy 
b-i uniblrtid into An ilg&braic GKprtseicni the eventual EvaLuation of 
which vtll resuH in the dddre^Q specification. There «re several 
featuras at the evaluation algorithm which must be understood for 
propvr ua o* iht algebriic capability. Fire-tt thp Drdnr of 
avaluation is not liKc BASIC. Herif the eKprasncm is evaluated froa 



lift to right, r»o^lM» of what operalDPs ipptir in the e>fOrtBsiDn. 
Fdt examplep th« exprenion: 

would bB evaluated ihihf following wav: The address of LA would be 
AKD'ed ^ith the value 1 . The result would be added to ths addresa of 
GH. That result ^ouid beOR^edwith sec. The result oi that 
cpK^tton would E» divided hy the address o4 IJ, The W nitssage of 
the ekpression converts negative ei^pfPsaian values to i twoX 

mmpleinem value by the addition of fi533* to the negative value. By 
way of tminple: 

-i ^ iFFr?, -3 = »FFFEi -2M = IFFM, end -257 - »FEFF. 

Finally, e>fpre35ion5 which result in vilutt gPealH^'lhin *FTFF 

mS2£i ^ made moduio 65536. For e>:amplei tfS!3e becpihas 2, 65539 
tHCHineB Sf vtE, 

Conpln tquiiiom 

for lhcH&wtro,wiahtoUttliiDrecDmplej< equations thar can be 
hindled by^ eHprtHuiOra i^hi* irr evakiated strictly left to right, it 
apMSiblB to ac™*«i*tt tteat bY *.MrjM nf BQU's which the^lvH 
ap* e:<ppesHiDns. Fw' tirampl*. tOraprisent an equation such as: 



^B■HC-^D/el)*^FiG) 

you could write the foliating cpde: 

I>E £QU D/S 
FE BaU FAG 
AB EQUB+C-DGtFB 

Ham^ mure cpmpW e«pre^ion.s n^^y t>a rrpraaented In a =imiUr fashion. 
ITiecEiHtntAeld 



CofliiMrrts ire errtered on the Btiterwrrt line by stSpfjino at 
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iHit on. tV«»a*tjrth.Dtwr*nd*isidhBfDre feeing tha f^omm^nX. 
Comnints »n not ■llowid an BYT inBtn^cliDns which dB^ins liiprai 
•*ings. CQiTtHifrrt»««u»efu] far documentation but do conwrn* otaorr 
*nd toouH «t njMbtr. of atatonentt per Hgmeot to ti€ Enallen. 

uritinv wOtipU wgMvnt prairw 

To write programs which arr too long la fit in i single 
Mgnent, th#re it onl^ ore rpquir*nent. AU rptsrincefi to labels 
which occur in tome other sEgmerrt mufil have an EQU included in ths 
ugment* which reference the nr. Jt is thrrafore nswsHpy to UKnttlt 
ft* segqiint with the mturally ocnrrang label hefare 4 final uunbW 
Of Wt ™**pencino Mgmtiits, ' 

BecujvA The A^nhier Htept Ir*!^ of We Imiior caunlep 
between ughenij It it not nmssary to includ* an EOU 4t the 

beginning DffachsLAnecwBntMBri*ntlflMt*hRto(*bDncomtir- It 
will, of cour« t^e necessary to set "ttw location Cquntffr if tht 
beQinfnng of the fipst Hfliwnt. The default frtrtiil value of the 
In^tun countrr is 
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OT-&phicB tH« VIC— 2e 

Thesp nevt chapters will atlempt to ^npund upon the 
informatiDn found in the VIC-?* Programnier's Rsference Guidt (PRO^ 
The- PRG should be coneiderec) an indjepentible retereiKe tooL In it 

you will fino complete fleficpiplions Q* -the various spp-cial fiirwttim 

integritecf circLjits «rfijch inaWe the- VIC the powerful computer it 15. 
Also includefl IE information on the VlC's memor^r orgamzation and the 

"Ktmal" roLrtmti and how Id Ihem. 

Thin thap-ter wtlJ provide the machine language program raer's 
perspndW on gra^>hiC6.ge™raliDn. Joy stirt and paddltuSdcw and 
uund g«itr4*ian w^ b« cayirttt uvthi fcriliowing chapter. Tt* last 
chaptw wiU tGver some orf the internal progrsms contalnul In the 
VlC's ROH «wf *he neans by which you can make uh of ftem. 

QstoB Ouractara 

The Video Interface Chip IVIC^ after which the VIC W9S namidr 
l6 the electrondc maiihirie, the integrated circuit within tJie VIC 

wbicTiif among crthepflungGj taoses pattemstatw displayed an yout 
vldM screen. ItiK^alcO lOttwnM tNn or on aome machinsE, the 

■iSil- The VIC *lpjSctm(rctedtothe45#a*nd t(wRAK and POM of 
the VIC via ihs jnldr^gg, data and corit^ bussn. He regi-^tepa ate 
wired directly to the addre-ss bus and may fie written Intn and read 
fram hy any program rianning nn the fiM2, The registers oco^ «ie 
addresses (We i36S64J- to l^fiflF (36875). 

Vdu have no doiibt noticed that each character which L5 
displayed or ^'our ecretn is a coiTiDOSite up to 64 dots arranged in 
an 3 by S bLocK- The information which describes the characteristic 

riotpaltamuf each cftiTictar is iWtfdrittw VIC'S TOH. 

A certvn sBcticin of RAH is r««rvsd for use by the VIC 
rscrnn- ne«Ofy- Ttwre ispMbj^teof KFetfi iwnopy r«5*rVKl fprnylly 
draractar position on thflBcrwn» ual^mmmmA^i 
rows there are SBd bytps of screen nWDur)'. Wtwn data, ifl atcTad Intp 
screen memory it gels translated into thvt patterns by the VIG 
The VIC chip interpTBts earti byts in screen memory aa icodo wAifh it 
has to translate to find the proper pattern af dots to put on the 
screen in the corrf ^ponding -ureen position. 

ITie BASIC 'mnT EtatCDcntcujita -sCPHn cadt^T to b« 
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Stored in Kreen rwrnorv. It iBpoB^ibl* also to POKE st^en codes 

msmnry. M^Ai^iangu-w pr^ra™.s ^.^ „or. screen cod« 
into Kn-sn mnory. A Cflde stDPm± in the first positior nf Ecnen 
msmor/ npiwrTta tft^charactfrlo Us dieplayefl in ^ imr-laft 
corner oi the «x#an- The 2Znd poBition irf men iwmary cDntrim the 
code which rBpressnts the chirarter wt^ich gsts iWspUy.d in tha «™r 
right corner tr>fi screen. Thp ^Uth pasition of stPBin mnWy^ 
conteins the code far the cinracter in ihe lower right comtr&t iht 

The VIC chip autamittcally and twtirajdlysc^nEthp scr-sen 
oi^nOry^'galting ont scrBPntafle per scre&n locitian and translates the 
srriftncodfi into ifi eight by eight dot pattern wh.ch it Ihen sends )c 
the ^ideo tMtpui pcDTt to be di=pl4yed. In appEndiK D of tht FRO ther« 
>B a tibJe of screen codes and the CDrresponding chiracters which Dflt 

The screen CQdes ire actually an 3ncfe>r into an ex G pattern 
table. ScrcefiLDfles may have 4riy valuf in the range 04 6-255 There 
fnr diHerent characters which -nay be displayed on a 

screen at my one time and 25i enlriEs in the pattern Uble 
J";" *^P^°^^^^*«*^^f'*t^^ntfouhoidlhe CcmmndcrP AnJ 
ttiB Siift keys down slmultaneDusly^ the characters which appear on the 
screen an from a Wcond character set. One character set conUins 
Lpper and lower case OwKters and Ihe other contains upper ct^ ard 

IL'^l't!^ wt'*'™' Th-« 4^ two B.ts of e « S patterns stored 
n ROM and tHe VIC chip can be -EWltdiKJ- beiween the sets. In-fact, 
the VIC chip can he switched between se^Tfral dif^trsnt tabl« of 8 x B 
patterns, two stored in ROM and others created by the nrogrammer and 
stw^d jn RAM. 

Cresting & pattern table is hgw cu si orr chara tiers ind bi1 
linage graphics ih accomplished. The pattern tables consist o* 256 
«t5 ot patterns. Each paTtern set hjE eight bytss. The « a 
Pittems tiKe eight bytes ot data to describe each pattern. The first 
byte r*prps»Tts the lop row of dots in the character. The sec ond byte 
represents thfl secvid frDm tTie top arW m forth. A frit tur^d on m 
any o^ the bytes wiU ciuce the correspDnding dot on the 5cre*n to be 
Illuminated. The sc/^^n dots. arB alw caUed pixelti «Wch: comes fr^m 
'picture elements". 

The sianOard char*ctflr set it stored in ROM StaHinq al 3Z7fi8. 
Th< screen cude "B" re tare to the fir=t a-byit p*tt«-n, «*t of the 
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character "3". The seccmd character tn the standard character HOH 
starts at 3277fi and i« the pattern *or the letter "A" (screen cMe l}. 
Kvery eight byles. another pattern is stored. This goes on for 256 S- 
bytP patterns- 1>ie patterns for screen codes 128-255 are the 

"rtverW of the first kZ3 pattsmft. That isi where a bit is on tr 
onvrit imirH in ti« other. 

aSwi MBory s-tar*! aieiliwr addrtei 7680 Olfttfl} if you 
have SHorlesB memgry flp al if yoa*rtv» BDM thin tt. 
Tti» ftrrt byte of screen Hwnory holds the ccrecn rod* which Ctua*? thn 
copwprsnblng 8 by S patlem to be displayed in the column erf 
the first rCT- of the screen- tl^e first 22 positigrW of urm MKry 
correspond to the first raw of the screen. The second 22 characters 
CHTflfipond to thE Hccnd row ard so fcfth. 

If- for ExaiFiple, the screen code "I" was found ir lotfltim 
7i88 on an unexpanded ViC» the VIC chip, Mt tc^ find the 3 j! 8 pattern 
tabJe mlarting at 3276S, wouid, in itt cdrrtirkJil scan of KPMn 
mtmptft find tiie value 1, ntultiply It by eight tg find the 
rffH>UMinen*intothe pattern tablff. Eight plus 32748 is 32776. It 
W0LI14 start ^'ftMuldnn iRjtli^ the dot futt«rn tfi H.raj to t^ 

H77i"™^' 

addr dec heji binary 



3277r( 24 lie Be^UflSQ 

32777 36 «24 80188189 

32778 ^£ 442 83988918 

22779 126 *7E eiiiina 

66 «42 81S988]a 
3Z7S] Ad «^ llfleMlV 
327S2 d£ «4Z llB«aBla 
32763 8 «89 aaBSBBBfl 

if you look at the above pattern of Dnev and lerost you will 
bt able to see the shape of the character -A" -Formed by tt* ones on 
the tiachgrifjund of zeroHi All of tht thirarter*' fhipti in iormt^ in 
the same fashion. The dwr»rteri you funn in your progran mutt foUow 
Ihe ftaite ridn. 

Th».infar**tim to teU th» VIC Chip when to find the pattern 
tJ«il»».»terfclifitherBiiistflratjDc:attDn»98ftS (3*S49J. The low- 
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ordw *cur hita tor lo^^^der nybbiti contrril tha Mledion o* th» 
uKi»n poaSiblt charirtor MtUblot. Ths milhoO of seiecting thsM 
possible are« is 45 follows: Bits 3-flp Ihe low-nrdftr nyhblE. of tH* 
daU storecJ at 3*8i9 dpfirw wtiich irea of memory is to be used for the 
character pattern table. The high-oriHr nvbOLe tf Us the VIC 
where screen msmory is iDCited. Man rtout th.t Ut*r. 4imowing 
table fftvM th« sixteen possible valuHtts diariutep-UbU ■•lict 
bm niOT hiVi *nd flw nenary addms** which thty cause the VIC chip 
to use for aw ctiu-»eter pattema. Tlie "n" in the first half of the 
byte nwans thai portiar of the byte does not i4iHl the seUf ti*n. 

•rtJ 48BBfl 32765 fJomiftl Upper Caseygraph ics 



«h1 


49400 


33792 


fteue^^e o-f abnue 


f^Z 




348Jd 


Normal UC/LC 


tx3 






1?eu&rEe of above 








Unaud Liable 






37888 


Unaval labl^ 






3B912 


Jnauai lable 








Unan-aHAble 


»)(& 




e 


Kol r«cGivBended 


*ie9 






Unavai 1 abl e 


%rA 






Unavailable 


»<8 






Unaijai labU 


4>lC 












Size 




*xE 




A144 








71 AB 


RAM 



A machine linguage rDutinfl to aoonplish *• switching 

bt- 

8U EOU »eC LOG 4B9d 
SU EQl) $90 LDC 5120 
SU EOU *flE LOC 614*1 

EDU UP LCC JUS 

L[>A 3*8(^9 GET OLD 

^^ND ttSFfl CLEAR LftJ ' SAWE HIOH 
Oftiv SET LftJ hJVeSLE 

ETA fiESET 
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Of cotrsef only one of the SUHC3U's would bt used, bepending on 

Which irea oi HAH 7du W4nttd ia use for the nrw prcQrimm^d ch&ncter 
^et. Ail areas which you might use for your programmeij character set 
^ust be Li««d with same thought as to the consequences- All four araas 
arf suitable but they «II fall within ^ aeinor)r space of BASIC 
ppograH on the urmpandvd VIC and W9£ it whtn tha-Ecrc#FiMffiorr» 
on tiw wpandnl VIC. fa UE« tiwn in coninctiiin Witii a BA^C tirbgram. 
it will be DMetsary to modify t4ie BASIC pointers which identity the 
start and end of BASIC program memory span. These techraqties ars 
epaJlitf DJt in AptwndiK 7U81san irrtere^ting location for 
chirdCter memory because when it is ^peafled, the first 128 
char-Actfrs are lAer definable but character codes i28-23S cause the 

VIC [hip to select the standapQ L^&r u^c and graphics ut. Thic can 

be in advantage when you wi^ to have both progrmnable characters and 
Xhe standard charActer^' Tt an be a disadvantage if you arc using 
the bit-nipptd graphici ttchniqiits ixplainta twlowj 

To tP9<it the MW characters it i* necewury to buiU a set of 
8^)rt«fMlt«mG in 4hvsaQie way thr original set Is conEtFuctBil^. H 
i»nQtn«t«w^ tDPciaraACimiplck^4fl b^^blociiiif qanor^ fora 
ccmfilete Kitharacteraifyouonly hawa^ew diaiMttersyou^rish to 
ever see on the screen. Howeveri you may not use more than one set of 
characters at « time. Once the VIC chip's ragistar at 3A8A? it^W) 
has been set ■ the entire scraen -will be gemratad using the -diaractar 
piHvrtK fowd at ^ meifi«d pittvm table uvi. 

AltemtstovM 

Having mope than one screvn in neoiory can be a nice, faattre 
for ireating spKial effvcti or saving display informatian for later 
uu and oVwr uwc tht f«rtl]t inaginitLon can d»viH. Ripidlir 
switEhing batVMen two scra«ng can cp**te the effvct of having t 
^oregroLni and background. Uhatever. The addrass of whert 

the K\iyt scrcEn is muGt be fitored into addrtES Sd&df along with the 
character oattem table address. It also hat a component in address 
Th? p^f]ct«5 D-F settling up alttmtft bcmm is ]eb than 

straightfon^ard but it still is manageable. 

The starting address oi screen memory has certain 
restrictions. It mu«t be an ryen multiple &t 512. This is awthif 
way of sayijqthat tlvlDiir^irdBrbyiiand the low-tirder bit of the 
hi(^i-wl»r byte of thfladik«s of the rtapt-of^craBn memory »u»t all 



b« PLrthBrnDTAi -the Moln-order -thr» bll&of ilw iddress musi be 
zonK. Th« highest kddr»a»iiiM«u^in«ythirHoi«tw«n^f^ 

dioniaL 04-^ Idbits of ttiiuldrm.of Ki^MBcnr, '(>^^ 
bitSifMVlw anything othtfpfrane. TheH-JntrbilSi bll» IS-*, tn 
tho bits which mu^i be stared in the VIC chip's f^giateps to ItU it 
where to find screen memory- ais IZ-ift get stared in the S-4 bili ©* 
Iccation 3&36?. The f bit gpla stored in ihe 7-bi-t of locsticxi 
It's a cDmfiiicaitd but a eimplB H-t at igscitibler Btateinenti 

niaKe tht progrimmer s job e±5ieri 

In the fnUDwing progrim segmcnti ADR is the s/mbolic UbeJ 
for the addi¥B5 oHhe memory Iccation whpre ytJLT alternate screen 
wiU bB. ADl is the value ccmpirted from ADR «Jth that tjita I2-l» pf 
Ajfflmid<4) in tho proper bit poaitions tt-4l of the low-order' byte ai 

gmratod addpeisi with ill Mhsr tote *uprwd crfJ lc«vidjng m 
UiOnss by 1*24 ia the unk m BMfting All -the bits f^Jit Itf bit 
positions and multiplying by ii is the equivalent of 5hi-fting them 
back to the left four bit pasition-a). AD2 is Itie value cojnputed to 
put the 9-bit of ADH into the high^ordei* bit D+ the lorf-order byte 
AD2. 

ftDR ECU *i;9ee 

i40B E^U ADR/ia24 

im 348^9 ■GET OLO IMLUE 
f*itJ #*BF TUI*^ OFF SEL BITS 
ORA (*AD1 SET SCREEN SEL BITS 
STA 34S69 

LDA 36B66 GET OLD 

f^ND 17F TUFiN OFF ONLY HIGH BIT 
□RA SET SEL BIT 

5TA 36866 

This will worK if and [}nly if the iddrtu ipcC]^ in ADR has 
its 9 iDw-irdcr bits and its 3 high-order Bi-b aff. ai ri^ibvd^ 

Somv oai^r -tya^n dit«. fleUs vdy have Id tm ModiiKd If rou 
a™ using the optratinffiystEHnnf the WC to affect »i<Kr™T. tW 
byte At iDcatiDn £48 t«Us tfic^ opent^ bysiim wtudi pagaihB KTHn 
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resides on. 

AD3 EOU ADR/25^ 
LGA i»AD9 
STA ^48 

ali that icrtt^iirfid. Thepe'ii*cil«oZ4bytC9 erf Bcriir^-siH<ip 
informetion (tells the operatirg eyitem which linee wrap arourxi onto 
the rWKt line TlKe in kxig BASIC statements) stcx'ed at locations 217 

to 740 which may need to Mved and rcctored every tima yjnj awite^ 
screens. Saving and restoring this inform ation is only nenssary If 
you are using the uperAting system's s^en dispUy tystem. 
Bn tddrtmbto (kafMa 

Bit addmstble of Hi-ru grsF^cf an-pUBflilfl via the U4i of 
thi progr^nim^ito dwicttp fttture. The t«hra£|UP used is 
.strMghtfiarward. A Uod( of the BCTwhneiBDry isprt^nitialired to 
rantaifi i atrtng of CfQMfttiaL ttcr«en codefi (the It^^t pasliion ot 
smfen memory contains a ft, the sHcond a 1^ the third a ?i eU,> The 
screpn meincry is oot further modified ty the program creating the bit 
afldre«abie gpiphics. The character patterns (in the RAH chanacter 
pattern table which is addressed by the VIC chip) are niDdified by the 
program instead of the screen memory. Tfiat isi the block tkf high-res 
Krein memory always contains the same wreen codes* the indexes to 
till- pattern table. The patterns are nodtf led a bat at a time by 
mnputing tin proper bil ^joutiDn in tha.ppopsr8'-bit of the 
proper character p»ttem. 

TTie sin Of tJw hl-rea Block it a fl»rfbn of i-vaiialila 
memary. Th» number of character pattern* necBBsary to have a I2a bit 
by 128 bit Tii-TBB BCTMn is Z3d. That would bi a i6 by ]£ dlocH of 6 
X 8 characters. 2Sd chftraders tike 2148 bytes of pattern 
in-farmatian. To bit map the entire ureen^ it vould take 27 n 2^ or 
5H flifitintt programmed characters. This is moff thin it K possible 
to have active at one time. There ii a solution to this prablemf 
bcftwvtr: daM>lvHtigh charuterE. 

fiDrfdf-4ll^ CharadHV. 

Vn VIC chip has^E«pabiUty of irrtvnntvig the diaracter 
Fufterh Idbitpattemrfc^r-^aneKS. By-setting 
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tfie iDW-ordsp bit of location »Tfl»3 tgseiTJ ta 1» the VIC cMp will 
miic logcrerate & do! «(*e by li dDlhiflh chapirtei^,. Todo tttiti 
si^te&n byt?^ of character pattern in^na-tlori- is'(jrdCBne=d tOT ah/ 

given characier ^oflff, ihfl tauie 0* tharflftsr Dat^ems muM bt 

conetrgcJetl accordingJy . it is impartfln-( to note Iftat thp character 
pattern table wiM nav have iwice as many byie^ oi informa-hon for the 
equivalent numher o-f character codflfi. A 256 characlsr t*t)ie 
taks 4#96 bylea c+ HAM. This is mure than is avail^lv on the 
unexQindsd VIC. 5di M ynj wish to da fuLl-ccrean his^'-PKolutiah 
pJottingi you mu^t liave e>rpjnfiion n^nory, 

Tti# pPDonsn In AppsmliJi D sets up a 123 >r 12a hi-rps bloc« in 

tne renter th«icr*tn and is designpd to allow 1 BASIC prognm \a 
selpctively turn on orn*tu%y bit in the matrilt by aimply poKlriQ the 

bit posations the X and Y ncordinates into Tsro page memory 
iDcatians aid setting a zero page indicator switch Id tell thf prograrn 
w^lether to turn the bit on or oH. This is very muc^ htcp the sample 
program m the PRG^ ewcept it is written in machine language and runB 
manv many times as f aai. 

COlop eonlrali 

Thtr* art touP hinds pt coJor tontraln in twc cateoDrieB. 
Smter ^doTrtH^rt ttithecDliTDf WiKpeMirouhd ttieoutsicft of 
thp qharacter display area ot thtscnwn. fiabignund CDloT relecfl.to 
the color the character dispUy irea erf *hE HrMn. ^Qptqfotwvi 
cdlor rHers to -Ehs cclOTtJf the detstupoed on within * chiparlw. 
Au3iiliary color is appltcabl* on]y fop multi-calar mode of character 
display. 

Hie auxiliary ari(} bacKgroLtTid colors may have all 16 possiBlE 
di+ferent hues. The Border ard foreground colors may have only the 
-firsi eight. 

Qode Color 



- Black 

1 - White 

Fed 

3 - Cyan 

4 - Hag«n1a 

5-epwn 
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7 - Yellow 
B - Orange 
9 - light Orange 
It 'Fir* 

11 - Light Cyan 

12 - Light Magenta 

13 - Light Green 

14 - Light Blue 
35 - Ligrtt Yellow 

Ecith border and bad^round colors ara detBrmined by the value 
of the memory iocatlon »mF (3^877). Bachground 16 set based on the 
vilue (rf 1»» four hiDh-orden bits, bits 7-A. The dorder color is set 
infl«tfi^Pt'l(W^o<:derbits, biUS-8. T^iefenwininQ trit, i)it'3in 
fliia idciticm detH-niinBU s^tber the bacisrflijrid/for*gpouTia 
colors are reversed or not. If ^ bit » on th* bacKgrcunl renains 
iui&d a-t the color specified in bits 7-4 and the -forflgraLtftd dote 
vary from character to character under control tjf color memory as 
described rw*t. If it is off r the background color will vary from 
character based on thEvaluetin cfiaj^acter-colflr nenar/ arvd the 
foreground Ittie datsl will all be tfie ccmstint color as selffctcd in 

The fOTpgrcxjid color is set for each tharader position on the 
screen. There is a 59d byte blocK of RAH reiiBrvett for the purpose of 
telling the VlC ctop ^f^at colors to assign io the 596 screen 
poutiflns. l^aiTHof RAK starts at t?dHi^flJ for systemfi with 
^ to of RAK and at |f W (37809) for sysieMwlth ran ihtji ^ 

ECadch hyVt <A ctjlor meimry hai the Angpotnl cidar tbde m ths 
iDwordfr three bHij This aUows Mch Character position on The 
screen to have tts color selectable, 

Th# high-pHer -four bits are insignificant. The value o^ bit- 
3 IS very signi-Ficantt however. It selects the node of interpretation 
of the character pattern. The eight byte bit pattern array for each 
char-actar code can be inlerppeted hy the VIC chip in two dUierent 
Vpiays. So far, we have only^ looKed at the normal or "hi-res" mode of 
interpretation. The second «iDdi is called multi-color mode. Bit-3 -of 
•icti byte of color weiiDpy will cauw the corresponding character 
position pn«wa^Hi tobeSinepMcdl(ihi"TMMde if ^ebitisa 
Hwillciu«v BKilti-cEdortote^ effect >ortiuttfiv-^cte^if it 
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is. k 1. 

Mliltl-colcr h1« 

In multi-cDlcx' modt I I^e citihl bylrs of (Htttm intormAtJii^n 
ATI not iBMUHBht^aw:^ Bigh^dgtfl u wilh high-Tfb. vi^tat 
bilft of #achr{]W art «»ti foL^ two-bit ftilv This mrarw 

that ir multi-colar matie the ch araclsrs displayed pr -thp scthh 
consist of eigM row^ four dots each. Because -the chftraftBra ifp 
iht same sue and can be dispUyed a1 the same tim# as high-pet 
chiractersp i^f '■^-ir horiiantal dots in each row are twice as wide 
the SLitglp wiath 6oti ai thm fM-res characters, ^rwther way of saying 
Ihifi ic: the muili-color mods □* tharictsr display 1*0* haH thff 
resalution in thp hortzdirtal directian as the high-res mode. 

With this model each ctiaracter di^f-Uyed may tiava up to four 
dLffvrecit culorsi SirKt tha moOi selection bit Is MtUblv for swry 
scrfleri pdsitioni nidth-calv char-acttrs najf tw mixed with the single- 
color characters on the Kreen- 

TTw tWLrWt EoloT codes which dt+int ^ totors U)a apa found 
in the pi-ttem taQle art: 

- background 
fli ^ border 

I ft - (ores round 

I I - auxiliary 

tDcation t9UB (3^76^ which controls the selection the auxiliary 
for illchirtcttrs ajntalra iJfl^ Tflls Mts auKilitry color to red, 

LctAtion >90»F O^S??) which controls ^e Hlection q4 ih« background 
color ind the border color cDntuns»4E. This sell the bicKgriwnd 
color to magerta and the border color to blue. 

Location 768ft (*lEfl«, the first character position of acnen neinory 
contaiTK a 9 which will cau^e tfie VIC chip tc find the Character 
pattern definition at location 7U&p the fir^t pattern. 

LDcaUon the- cDlor-cod* table portion fv a umn 
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code of 9, contains the vaJui litfr (>rxit!r IfHl where n indicates 
Lrdmportanf' Signifies bUcU foreground- color and multi-color made lor 
■B» first «rei»nc;har»ctwpOTitipriiP*#inbitpoaitlons 2-9 tor 
tdadcand i in bit position 3 for muItl-colDr. 

Locations 7168 through 7175, the character pattern dsfinition bytes 
for ^aracter code 4i contain: 

illi jni IFF 
1414 leitlAA 

ei»]«9«i tss 

««ei 31B 
m\ leii >1B 
eaei leii *tB 
mi leu iiB 

Tfie character wKjch will appear on the screen in the upper 
Uft romfr w^l have t red line iciwa the top ( fojr double wide 
dots each with the aiLiiliaPfC(jliiir ,oJ red), U will have black line 
UOdflr tiM red line (four tiMfv of 14 indicate four fcregrtiund co^or 
Haiti, ^nra^ ihit win b« a blue lini Tfour bordtr aftif dots). 
Beneath that will be a magenta line ( four codes of AS sigr^fy 
bacMground colorl. Below that will be four horirDntsl Urtts of 
magerrtaf bkrsf black and red going from left to right. 

If yotj Lnierstand why all th«t i& true thenytiuttave a good 
grasp of color gaphtcs on the ViC-Zt* 
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5±icK9 *nci Sounds 

Joymtidd 

Host irput and output Id and from ihp Vic-2ft is accomplished 
with -the assistAnce af iwo Ertlegra-ted drnjitsi the £521 Versatile 
InleNace Adapters (VIAs). LiKe the VIC chip, these twD acvices are 
in CDirmjnicdticn with the ^thflZ and th? ^OH and RAH devices via the 
tiWress, datL infl control busHS. The funclicnihg Ihese chips is 
under cuntrQl oi their sixteen internal addre^^ble registers. X-iMn 
the VIC chip's regiEtensi the VlAs're^tttsrs may b? loidcd and saved 
by pragpams ruining on the 65*2. THi 32 Pftgisters occupy tha 
addresses f Vi yt - tUZf <37]3fi tc S^mu 

The VlAa arfl ^er/ pttw^rful ania tOFnple^ devicec. A complete 
description of their u^e is beyoid The scope of this t*d. Wq will 

present the ^erteral means of doing input and output through the VIA5 
artd the speti-fic means o-* orogramming *or jcysticH and paddle iree, 
Fer 4 complete technjcii deati-ipiiang-f jdvanced usage anfl pragramming 
0^ these d*wic&Si you shmjJd acquire the t«chnical spetifications from 
HOB Technology. 

Each D* the 6522'^ has twp input/output portSj Sach port u a 
set 0I eighteUctHt«I connections between the data buEof t^e VIC 
and world OutBide tKf VIC, Thfl pofii tfm ce^bd po-t K and port B. 
E^h port hasanasECCutedtialaillrei^tlmra^iB^epmp vvtiich is 
used to sei the lAO pOrt's eight Uhes to fiithnr iniait'o^ output or a 
rcmbinalion. 

The DDR -for VIA #1. port A, is found at address I¥li3 137139). 
Each at the port's eight lines to the outside world may be configured 
at any tims to either accept input in the *orm o* a voitage signal or 
to produce outsut as a voltage sigral. Ail lines represent a load of 
one standard TTL gate in the input mode*nd will dri^B one standard 
TTL laad ir the outfjut modep 

The J/0 lines of port A, VIA tfl are desigr^ted lines *-7. They 
correspond to ^he bi* oosi*ions*-7 in raeraorr loMtion HlU (371371. 
fleteiving input -fronwpirttirTg artpj^ tfl is as 

aimpK as reab&Tgfrom or- writing tiJIhStjnirnDr^ IbciiiWi. First, 
be+ore actually rsading or writing tfe fla1*» it^fteasW;' to »631 
the VIA which lines are connefted input devicea ■•nd wfiliph are 
conneLried to output de-vices. 

The DDR'« PiQht bits copmpDnd la fri eight bits ot tfir I/O 



port. To wlect any given lint AS an input lirwi thi corr^EpDnding 
bit of the DDR must be »vt to 1 «. Toidtrrtify « line of 1t» port is 
an «ijtput line . the uTTE sponding bit ^ Ite CBA nnr«t to^ 



DDR ft •■9113 137139) *9123 (37155f 

Por^t A *?in (37137) e513l(37153> 



DDR B (9112 ^37138) *9l22 t37i54> 



Joysftcte hivi #iVB iPiErrialswtfehM. They a3aDftivm»5«jcB 

of 5 vOttpovrtf' Which the Bwitdies dirlfot tcathe appropriate pins of 
the conrrectar. Whpn the joystick is tippsd in one 0* the four 
directions the switch for that direclAon is dosed) sending the "orV 

signal l-f-5 volts or a binary 1) to the proper connectpr oin. If the 
joyslkk IS moveo tD the diagonal position^ both Tri* switches are 
dosed. The other switcties send t^e "off" Signal voUs or binary 
&). The fifth switch is the tire button^ It'a signal is a 9 urle^s 
it is pressed, when it bocontes a 1. The connector pins are directly 
wi^ to the VIA i/Q ports. Thtrt is a ■'TOP" direction indiHtad 
most joysticfta. The owitch aEsociate-d with that direction a conmctsd 

tohit^Sirf VIA#l, Port A. 'BcatWrihenitWi-B ot\1A ttl. Port 
A. ''Liff iB bit^f Same port. T>» -fir^ buttonis hit-5^ ttane pffli. 
■Right' is atlacned to bil-7 cf VIA H?, Port B. 

SOf to wn^e the direction o# the jay 5ticS( and wKfethtr the fire 
tBLrtlon IS being pushed, two J/0poft5have to be input to the program. 
Port A ai VIA Wi is used for the serial port as well as the game port 
anfl Port B of VIA #2 15 useti +or Keyboard injujt as well as the game 
port so it is atJvised that if you wish to use either of those devices 
■Her doing joysticH input that you restore the original ^Uue o* the 
Dlffis After doing your JCEystitit reading. 

The fOllDvlna program segment will Hve the DDRs, set them for 
jpjfartidt trfftit, read jta Joysttdf swi^tehe^ amt sa.ve tlv switch values 
At bit* stt irrstDTage tociiiori t. 
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DO-filA EQiJ «91t3 
DDft2B EOU *91^2 

I02B EflU 593?e 

LDY DDR2B 

LiW ttiCS INPUT BiTS 
ETA DDRIA 

AND (»*7F pgRCE 7 BIT OFF 
STA 6 

STX DDRlfl RESTORE 
lD« input BIT 7 

£TA 1>DR2B 
LDA i02B 

AWD naa fqpce all bitt 7 bit off 

ORfi 9 BLEND WITH REST 

STfl e 

ETT DD«2E RESTORE 
RTS 

Piddlti 

Thsre may be t*o gam? paddlBS comettefl to the VIC i-t the ejnie 
time. EatJi paddle has boTti i awiliJi and a ^alue which uaries the 

piddlt 15 rotated. T*ie variable value Eftay hive a value bslwen ft and 
2S5. The switch will he either a one or a zero. The X paddle-'s 
variafiie valw may be r&ad from localion (79flS (36S7Z). The Y 
paddle's variable value may be rean ^roin location 19399 <3A&73J, 
ThBM aftlocatianB wilhir iher&gis^er set ai the VIC chip. There is 
no prpparatian receeaary to set up Wie rfiaflirig of tiiese values. 

Ttw Kwit^^ HtlingB .of tn«t\^KJ paddtss is input in the 
identical fltapmEr- «^ swiichiBof the Joysticta. In (art, the 
switch fcfl-paddlflXi&.thefiaiBE bit, pdr^ and VI>*i*s1^e''left" switch 
ot t^ie jpystid*. And ttw Y paddle switch ifi-ttB ttn* u tt» Vight" 
switch, Tht umifrogramaswaBgivtfilePeulthF jiyBtiEHftBiy bi 
u»d to read paddle switches. 
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Ilw VIC chip has the addlttonal function flf providing sound 
H^HKt c-qubiliUes. Ttisre ar« five regiEttrs In ^ V^C chip which 

Uttil to eonlral the sound 4ijncti[». Sounds are gEwritpd by iKe 
V7C diip i-nd aent tD«w cdmected TValorg with the video signail* 
The five r-egiaten are addressable by any program running on the VIC. 
Thfl-y ars ve-ry Simple to prograin. 

The VDlum* control register shares location 3^378 (l9eeE> with 
the auxiliary color reQisler, The volume cHrtrol je set in the kw- 
order four bits of aiS7S and the auxiliary color indicator i-s in th& 
hjgh-order four bits- The vdiume may be set to a value trom a to 15, 
setting the volume dH and 15 eetting it at its highest setting* 

ThB VDlumc setting ontr^ttivvDluRW Of all four 'voicN"! basir 
alta, floprano, and noise. 

ftacK veuciris.inddpendBr^lyu^iiKriiablfeHlDiU frequency 
but ndt its VDlunfl. The h^h-orderbit ai wiKh vnifre register may be 
considered as a voice 'switch". If the bit j|»on{4iu v^alue of 1 ), 
thB voKH is acliv&ted. If it is a # dp dU, Vnv vaia it 
deactivated. The remainder of the register, the low-order 7 bits 
cerrtrol the -freciuency □# the sound generated. 

US TV ^tB, INTSC ttandanJ), differ from eiimpean setf in the 

frequency range of each voice. All of the voicbs may be heard 

EimultarieDusly if they ere all switched on or any CD^nbination may be 
en fel any n time, "riw geperal *DPrnuU fOF equating frequincys from 
regtst^ values is- 

FrKi = capcH/U27-» 

1«ft*re X IS the 7'bit register value in "toe f^nge of ■ tn iiA, ForX- 
i27r the formul* is: 

Fp*q= CIkKJ m 

The folowing table summarizes the various VDiciSi their "Clock" values 
*ntf the nenory locitlons of their r«git1fr«: 
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Bass 3i&7l *99BA 
AUa 3^575 iPBBB 
Sprrao 3^67* tSBOC 
Noise 3^377 tPeaO 



clock 

(UB TV'O PAL (EuropsanJ 

15980 17323 
3196^ 34iS4e 



The .theDry. and (ecrtniou&5 at r^sic syiitftfisift ir^ti sound effects 
istre^ondihe scope of this testi but bo^ 1hE ProBPammer'sHefprence 
GuidB ind -the VlG-'29 liser^s Guide provide some ir-brmation gp crealtrnj 
sound Effects ^nd musical efferts.- 
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VIC InternAlv 

T^e ViOZft tames with fSK o-f ROK in Whidi the iptemal 
opEriting pTDgrima rEside. These are the pragrams which interpret 
PHASIC progr-iins ind which carrtrol "fhe input and output devices vhiiih 
come with the VIC and those v/hich can he added. This block nf metnory 
Extends «CW TOiFFFF, Some of the intemai programs fiave been 
documented by Cammodore in their Prcgraminer's Reference Guide. These 
are what ihsy calHhe "IfemaJ" programs. The> deal mainly wEth 
input/Dutput (I/Q) procES-Bing on ihe VIC- This -CEift will not attempt 
to duplicate the in*orifia1iDn pu^cvided in the PRG, i1 is onca again 
strongly retam mended that youobiair a copy of thai neferenw WCPk. 

There art m&ny other subroutines included in the VlC's ROH 
which arp not covered in the PRG. We will attempt to pro^JlE 
in+Br-matiooon'UsliT^ t^e rlWE.LJ5eiijJ-&4tftpM. UE-^?lli.lsDpr*6en! a 
li^ of the Entry fjodnja Of the remainder. Thboe whic^i are not 
discifseed in detail may ht detoded witTi the DecddBT' for yciir 
inspe-ttitin and undwstW&ig ■ 

Ariflimettc routines 

As BASIC processES /our arjthmetii: eifpresions, it usee a 
variety of machine language subroutines to do addition! subtraction, 
psponEntiation* irig functional etc. Tliese subroutinps ar^ avaiiacio 
to the machine language i^'ogram for accomplishing tiie ssme functions. 
They are alWairly sitniliar in the conventioriS Dt thMP UM, i-B- (h« 
means of passing parameters, getting the result5» file. 

Numbers in BASIC may be e«presssd as either integers or as 
"-Eloating point" numbers. Ints^eps have nn frartsonal comparient- 
They are sixteen bit signed numbers which may have the range o* 
32767 to 32763. Negative numbers are expressed in tWD's complEment 

notation as tliscusseri in chiptpr ■four', 

BASIC does all its coniputaticns in floating point niode. 
Plcftting point numbers hive fractional components. They are composed 
of three pnrticnsF the exponenti the mantissa anfl the sign. Tlw 
exponent occupies one byte and its binary value is 126 greater ^an 
ifi» exponent being sipr? ssed. The value the BJ^prnsBed eKpofwr^ifi 
the rtumbe;- li* bits wTiich the mantissa needs be sf^ftetf. Sj^fiifiB 
eiLpment expression is stored in "excess l^ff'T tlie range of actual 
PMporients iE-12S'tD ij7 tstorfld is 3 to 2SEJ. Ne^aitivp pd<pcintnt5 
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mean th* n>nt»« {AiI Btorvd^nnds toMihiftnj to thi right and 
pn-sitive exponents m«anfi ths mantisea needs to be shifted to Ihi lift. 

The mantisu is a ^Dur by te binary value P It is ^he shifted 
value of thB number to Qe eicpressed. This is ]ihe scientific notatign 
Bs u^d in physics and ch«im«.try. The decimal sy^lem c-F scicntifkc 
natalion wau\i\ SHpress ths rwmb*r i28765A&.7i5 45 1.2&745487A5 > fQ 
rajecd to the 7th powpr. In BASIC you would see this number printed 
as i-Z37^5i&7£S S07< A decimal e>[pi:rr«nt nf 7 in scientific nataiion 

means the cledntdl poicit needfli tQ De 7 places ic^ngM. Or 

t^at the mantiHa n»ds to bo mjltuilied by IS raisid to ihpt Hveri^ 

]t wy«« t^ »ni way ^th floating point numbers EKctpt tiw 
mantissa is in bmary and it needs to be multtulied by 2 raised to tha 
power oi Uia e:<p[]rwnt. Hultiplying k binary number by t^o js the same 
as lifting It one bit pQ5itiCfn. e^. 6 = 9^^^ And 12 = 

CBk BASIC always normaliEES the fFiantissa before saving it irr 
the -floating poinl format. This means tha'. H ^-r-'t^ it so thp 
leftmost hit is always a one bat. The nunaber 6 Ibinary value - fleflft 
4110) would bE Bhiftnln iJial thi nnrmalizcEt mantiEcawDQld be llflfl 
MM. What goK. Irrts the sKponent field is 128 plus -the number of 
■Significant bit po^ttiDfis in the orlgirul number. 6444 filiO has thna 

signi^cant bit poaitiohGi «j the npbrwnt would iw 1 Jl. 

A few Bxaipples wiU be helpful- The binary representatiion of 
the floating point storage of the number & is: 

leoe 0B11 iiae eee9 seea eese 9eee eeae »eae ease 
131 192 D 8 e- 

«83 £ce »ae «9e 

eVfionpnt nant i ^sa. 



The exporent ot 131 wpfe«ntsafi4ttgale»rpei^fr'rttif 3C131 - 
129). ¥du may consider the mantissa ^s'a fraction i^ith the radix 
point (decimal point or, rather, hinary poiTit) Ijst to its left. The 
amnunt it muat be shitted to get bacK to i ita adual vilje is three 
bit positions. In other words-, the radix point must be shifted frcmi 
left of the binary number three places to the right. 
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laaa eaei laee eeea eeea eeee aeaa ease ease aeea 
12? 12B B e a 

431 tee ^ea ^aa t«e 



exfianen t nan tt ssa 

Hit nunber z (aeae aeje) 

IBflU Bfiifl 1006 eeea sees eeaa aeaa eaaa 

\Z? 12B 9 e e 

«82 t&e «ea »i3a tee 

eiepprient mantissa 

The nunber 2 (flisae a&iU 

im Bflia 0e«a eeea eesa eeea ftasa aeae a«eft 

iz? ITZ a B 

«S2 «ce «eB tflfl «eB 

ncporrent man t Lsca 

Th& number &5 <^n& e^fiO 

laea em laee seia aeea ease aeaa eaaa eaae a«ee 

135 laa B a a 

«Q7 «8S «Ba «aQ w 



The sign of the number is carried in the high -order bit of lha 
byte foU-Qwing ^ mantiMa. It tha sign bit is om the number is 
nigitiw.. [f it in positivftj 
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Thar* are two tloating point accumulitops miintaintd by BABIti 
FAC1 andFAC?. FACl is Icxited at (^T-lftJ} and FAC2 i| at 

W-*6B (J#5-llli, ThMt two tccumulitors are u^rd tor dll 
ma^natiCAl operations. FdlQwing -the FACs, &t >£F fl la a stgr 
CDnpuuon fUg. The high-ordfr bit* if cn, dignities the two FAC'e 
are of differing vigns. 

AritiiHvtic routlnM 



Thf following rcutinea (wr'^onn mathimiti^i Dperilians uain^ 
Vns floatir^g point ii:cuinulatorB FACl and FACZ and valuei Eto^ed in 
other tnernory locationt. Each routine may b> flKecrted by a JER 
instruction to the uidicalcd entry pointr HEferances to raeniory 
locations are frequently canimuriicited to \'arioiJB routinps by an 
addreaa contained in the A-rpg (LSB) and tfte V-reg IMSB). We will 
refer to ■l^lH fortriat a? fwmit-li 

Host of the -Following routines use the A-rpg* t-reg and Y-reg 
fnp connunicatiDn. H Ie in intereetirig fact that when a SYS is done 
from BA&ICt these thret regislerg are loaded frcm memory ^oratiDnc 
7efl, 781 and 7gZ respectivelif. Wifi therefcre possible tocaD the 
fDllDwing routUwB and tto^i^'in ihe Mirnftl fi^m BASIC by GVGing Id 
theoi after setting up ^ Uiree regicier stcrage by^. 



IfTtcger to PACt - ID3Vi (S4161) 

A twcl-t>l^ie irrteger vilue in format-t is converted to a floating 
point number stcrsd in FACl. 

FACl to Integer *DlAA Q3«74> 

The FACl ifi converted to « two-byte integer whith is saved into 
lOtiticm 4d4^£S }. 1^ FACI i% destroyMi. 

HtBcry to FACI »imA2 

A five-b^ -fkuting pcirrt numbar anywhsre in memory is leaded 
into FACI- The address of the starting rremory iDcitiw is in format- 
I. The sian flag of FACI is set on if the high-order bit o* the 
mantiasa is a ona* el-se it is set off. The exponent is retUfiM in 
the A-r»g- 
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An AfiCn Wring ^ xtrmiptH tofloitlFiOPOlM ^dmBit^nd aav^d 
miMiFACt- Thefitr^i^iMybrartirNMraiJ^MiKry^ 
«he ftUrting locafebrt nuM &f pointtd tOby ^ Utitltr string pointvr 
at IZZim (34.35). The Ifngth of the StPtng must' be loaded into Vh 
A-ToOi 

FACItoASai *DI1DD (5^797) 

The ASCII representation of the value in FACI wUi be eaved 
vtartUig at HiM (25A) and mntfninna until al« is encourrterB-d. 

HMOrr to rAC2 ADAeC ^9948) 

Game as above except using FAC2 and the sign conparuon fUQ is 
ut. Tte*wpOWrt ftf F ACi ii PBtimKl In ti» A-rtO. 

FACI to H»may tDHDT (SdZTf > 

The FACi U Stored into any fivB byto atfinory lecfttiDn. The MSB 
of the address of the start of the memory location ia paiEsed In the X- 
reg. The LSB is in the Y-regn The high-nrderbil of the mantissa 
field is forcBd to the FACi sign flag. 

FAQ to FACi tDfiFC 

A liAFdt HKivi U perfarmed from FAC2 to FACI. FAQ it not 
a^^ctffd. 

FACttiaFACZ tDCIF OASaSJ 

A limplB aove is perforflied fron FAC^ to FAC2. FACi i« not 

Logical AND of FACi and FAC2 *CFK9 

FACI tnd FACZ are logically ANDed tEffiethEPp the nsult ending 
tfiiinFACl 

LogiCAlQRDfFACl VriFACZ ICIBi S3ZZZ> 

FACI and FAC2 a™ loflitally 0^w6 togetfter, the result enc^ in 
in f ACt 

FACt * FACt - FAQ >S833 OSm 

FAC2ifKiiti-aft*dfrniFACi. theresultfepUcir^'VACi. FACZ 



In not Affected. 

f ACl - FACl * fACS IWA 054t» 

FACl 19 replaced by the sum erf FACl and It Is rvcEsury 

to Ht ihM ugn coinparB iltq prior ^ calling thifi rcjutinv. Thin is. 
done by SOPirig kxttions i&A tnd C£S 414? «n4 and staring ths 
result in >£Fp It is ■!« nectaaary to loid the A-rtg with the vtluv 
found in |£i (971. Not« thdt bntti of -Bibh functionE at* done by thv 

FACl - FACl • FAC2 *DA» 690561 

TACl is r«plAC«d by -the prDatirt of FACl AND The mm 

Mpply i» fir thi ilnv* routm. An ilt»™*» ■ntr)' pnSnt tor 
this mutint i> 65846). This vMry point will vututir Hw 

memeDry to FAC2 routine before doing the mulliplicAtion. 

FACi - LOO i FACl 1 *Df«A QSTW 
FACt 19 replKid by ^e LOO of FACl. 

FACl - FACS / FACl IDB12 QAIBZ) 

FACi iEraplacAd by thQ (putient of FA(;2 and t^ACt. Ths »mft 
notsv WQ^y aa for addition. Hoveverby JBRing to tUBtJF 6M79) 
im'tTid. the louling of the FAC2 from Muary will tH UEiimpllUieil 
pricr to dis^on. 

FACl ■ FAC2 ^ FACl IDFTB 87211) 

FACl j9 replaced with FAC2 ruBvd to th* powir of FACi. Bami 
conmBiitE as for iddition. By using 1h« IDFTS 1372^8} sntry pointp the 
routira to load FACl from memory miy ^e e:<ecijted prior to the 
e!<ponentiatiDn routins. The Memory to FACl routine does not properly 
sal ir^E signcompiPt Odg however- Also note that when using th#se 
iltcmalE Entry pDinti. th« ume ittup of the A-reg and Y-reQ must &« 
performed » per Krnt-t^FAC mut^itt before csll^ ihe desired 
trithn^tic routine. 

FACl ' WACi I 1* tDtfl (MMO 

FACI UrepluedbyFj^ /U. 

Covpvff FACl «nd Heaarr IDCBflaMIU 

Hw A-rcg ifl set dvpefHttng on the pewit of the aunpiri bvlvmn 



fiaMelM W 



FACl end some -floiling point number in 1 cpeci-fiid [Mmory loution. 
if thvy 4re K^Mlf the r««jlt is 1, if they ere not ei^ the result 
iv SFFQBSl. The fttftfrassof the itirt trf the nenory loutiDnlain 

FAa-AflBlFACO IDCW OMffi 

TM FACl li repliced by the ibiolutr vilue of FACl. 

FACl * IHT \ FACl 1 >DCCC (M524) 

The FACl 19 replited by the inta-gtr portion of FACl. 

FACl - S«l K FACl > »DC» 0^977) 

ThiFACii9rtpi4ct4by1htY4tui«»ftW4W0r by li^^t 

was gpe«ter thin zero end by -1 if it wu len tti^n. W>- 

VACl * SQR ( FACI I IDF71 CFTZttl 

The FACl is repUced by 1h* square rool of FACl. 

FACl ■ axP 4 FACl ) >DFGD(573»)' 

The TACl is rppUted hy tfie vAlue computed by rsising e of 
mturil logirithFn fa me to the power of FACl. 

FACl ■ COS [ FACl y »BU1 0>V5St 

Tlic FACtitrcplufldby the Cos^of FACl ixpreaMd Inndiim. 

FAd-miirAiCl) UX3I6MW 

The FACl isnplecedby the'&npof FACl ixpreBSwr in ndl«ns. 

FACl - TAH ( FACl 1 >B2Bi 08133) 

The FACl is replaced by the tingent of FACl eKprsKsed in radUnc* 

FACI ■ ATM ( FACl 1 »3IB 6812» 

The FACl is rsfileced by the u-ctengerrt of FACl Hpreeied in 
redians. 



fipeMutputroutkM 



Most of th» 1/0 roiitinu er* pr^MTpted in the PRG tnH «M)n irv 



twD RGPf pptuftttd hvrt wnich do rut tcipetr thtr^. 

Input into BASciHiHfr •CSfttfHSW 

Tht 88 by1« BABlCJrvi^lM^fttaplina^tl^l fS12] 
fillod with character**™ ihi taybMrt. A CRetirfr] ttrminartM tte 
input ana ■ IflA tigni41»« th« end ?f thfl msug* in ^ buffv. 

Output stHng to vo-Hn >CB1B <3im) 

The atirting address o* a string o* ASCII charact*rs Id bt 
printtad on tha ia-tfr\ anKin fomii-l. Tha must ba 

taminalad bytm. 



PagaA-l 



AppsncSlM A 



Modt I 2 3 4 5 ^S 7 B ? II 11 IZ J3 



ASL X XX UK 

BGC X 
BCS ir 
BEQ X 
BIT n It 

BHl X 
BNE X 
BPL X 
BflK X 
BVC X 
fiVS < 
CLC M 
CLD X 
CLl K 

CHP xxi x^x i(id 

CPX XX X 

CRY M X X 

DEC MX X K 

DB< X 

DEY X 

XX XX 
]NX X 

Jnp X H 

JBR 1 

UM KKX NNK XK 

LDX K V W X X 

LDV H N X XX 

LSR K XX H X 

NOP > 



Inatdt-nw VIC Pi4ff A-2 

Modt 1 i 3 * S 6 7 a ? Ifl ll 12 13 



find 


* * 






rrl r 




PI A 




PI P 




KUL K 


iJ 




X 


Ht T 












stc 








SEJ 




STrt 


a: 


CTV 




STT 


1 


TAX 




T*^ 




T3X 




TXA 




tXs 













J ' Accumul ator 

2 - Imniedi ate 

3 ~ Zbtd page 

4 - Zero page^X 

5 - Zero pa^e ,Y 
i& - Abulute 



V X IL 

K 

X 

V 

a K 

X X 

X 
n 

tut 

N 

X 

y 

V X K 

>: >: 
K 

X 

K 

A 

X 

M 



7 - Absolute, X 
S - Absolute, Y 
9 - IJlipHfd 

IB ' RH4tH» 

12 - nudJP^-tJ 

13 - <lndir#ft) 



PqtB-l 



Dec 






t 


J ■ h 

ill 


aiiBfi ■nan 
lelB Ills 


i 






1 


UZ 


ISIS vlll 


3 


m 


IIVI IIJl 


4 


Hi 


nil ilH 






IWI 11 K 


i 




HH It 11 


7 


*|7 


iiii ill J 


8 


4IB 




9 


tif 


iBin LIBJ 


IB 


»9A 


ml iBil 


11 


iH 


ft n nil J A 4 p 

IBBfl id] 1 


J2 


»(C 


[Lu [Lu " 1 QJ] 


]] 


m 


BBBit IIbI 


14 


toe 


iHl 11 11 




«F 


HH Jill 


U 


111 


Hfi mi 


17 «]| 


■hi IHt 

vni wif 


la 




QBfll HUB 


1? 


«La 


■I'll 111! 


2t 


«I4 


III! nil 


21 


115 




22 


tJA 




Z3 




lvl] Bill 


24 


«ia 


m\ iii# 


?5 




m\ m 


24 




mi iiLi 




«]B 


HI] llll 


za 




Ml] 11H 






mi nil 


31 


•If 


mi nil 




41F 


Mi nil 



DfC Hei Binary 

32 «2» IILI i«ie 

32 «?] fill S»! 

34 %22 ilii me 

35 in llll llll 
U «24 UJI llll 

37 »?5 «ll IMI 

31 ti6 nil lili 

39 127 llll llll 

41 1119 1I»B 
4^ 42? llll llll 

42 %H< m\ Ilii 
42B efll« IIIJ 

4'i «2D nil 

45 yift 13IJ 

44 «2e nil llll 

47 f2f Ull IMJ 

49 t» IIUHH 

49 131 mi ml 

51 ^^l m\ iiii 

51 133 llll llll 

^2 SS4 1111 1161 

53 135 lin llll 

54 ISA Bill 111! 

55 137 llll llll 

56 -t3S Blil lfll« 
«3f Sim IIAI 

5a 1» IIU llll 

V ^ Hll 1111 

U tic llJt LIH 

41 130 llll nil 

«2 «3£ nil till 

43 t3F llll IIU 





Hti 


9 1 nify 


□•r 


ill 


Bim HID 


AS 

VlJ 




llifl <Bflt 


M 


Id? 




et 

v 


MJ 


11 IB U^l 
llll HJJ 


H 




■TBI I^IB 
ILfll I JIB 


a)" 






/■ 




ac«| nil 


J J 




BIIB IMS 

flin ■111 


Ti 
iC 




fit in l-BIB 
tbIV OKI 


7* 
lA 




II VI Ivl^ 


"■J 


m 


II IV nil 


/3 


lip 


B1BI llll 
win IVH 


7a 
JQ 




llflB \ IBB 






itBI 1 1ll 
■III Jill 


7R 


<|[ 


IlH 1 1ll 

■In Jill 


7S 

1' 






M 


•*»■ 


llll H|| 


di 




aiRi hni 


e? 


4^2 

Til S- 


111] lill 


□J 




llHI fedll 


ni 




DlDl DJUB 




' 


BIHl I1B1 


od 




Ailk 4111 


ft? 




I1B1 llll 

TIf J Bill 


B8 




llll llll 




IS? 


llll llll 




t5A 


IIU nil 


n 


IS 


i]i] m\ 


n 


IK 


llll uu 


93 


ISO 


111] nil 


H 


iX 


nil Llll 


H 


Iff 


llll 111] 



n m iLii ml 

V ui ijie i«Bi 

PQ Ul lilfl «B1B 

n U3 iMi llll 

in «4 IJII nil 

til MS llll iiii 

112 W lill llll 

1B3 %i7 lili 1111 

IH tie Bill i»i 

115 (df lilt ll»l 

Ll£ W llll 1114 

117 i^B 4J1B llll 

1IB 4^ me 11IB 

Itf 1^ llll 111] 

114^ llll nil 

111 w nil mi 

112 71 llll lUI 
113-|?1 111! HI1 

114 472 Bill Bill 

115 473 llll till 
lid 174 llll llll 
L]7 475 flill ^Ifll 
lie Hi llll I11A 
II? 477 »lll llkl 
121 «7B 111! llll 
J21 479 llll IHl 
m 47A llll ]ll« 

123 t7B IMi llll 

124 47C ill] UN 

miTQ. mi nil 

m«7E llll llll 

177 i7F llll nil 



Inalito Tin VIC 



I2fftH im HU IMMI Illllltl 

LiHaill UtIlU. miHll 

I»i82 Jill »]l Ii2«Af ItllHK 

131 m \m «iti 143 m mt uu 

m m im am 1^4 ibii mi 

i34 te^ im aiJB li^iu iiii ini 

i35*e^ IBM ill! W7 iiLi eiii 

134 tee ii«a i^a m \m \m 

137 (09 IISI ]IBI IBIA 1111 

135 ttt lilt ITHftVt IMI. J|JI 

J4iiee m im mm mm 

142 «BE mt Jill 174 «E 1818 lilt 

nstsF IIII nil 173 lAF lilt ini 

H4t9a laei fiMB \7i.m \i\i%m 

i4i mi 177 IB] iBii im 

iA6m \m m ib2 m\ ini 

H7 1?3 1181 eeil 179 IB3 !«11 fll31 

148144 III] m m tB4 llu llflB 

151 i?; miiu iB3r»7 ttiutii 

157 «fe 14411111 mm jin im 

153 1^ 1IBI l#l] IBS tflf 1911 iiei 

\m iai« isi tu ini leii 

155 t?B 1B81 m\ 1B7 tBB IBIl llll 

156 m 111] \m m iBc 1111 iiei 

1S7I7& IRIl IIIJ 189 m m\ 1111 

159m 1181 nil 1?l I6E lilJ ]11» 

15! m lUl Llll 191 »QF 111] lltl 



n&f Hn Binary D« Hrt Bnary 



192 iCt llll 1611 ?M»EI IIKIIH 

193 Ul 1118 HBl 2»tEl Hll IHl 
iji «C2 1181 IIJI 226^2 nil lilt 
mSC3 lllfl |«ll 227 Kl llll l«ll 

m %^^ im mi 729 tEi lui «tifl 

iw «C5 1198 eiei 229 if^ ma 1181 

194 tC4 iU8 Bill ^ »tA lue itii 

19? n? JISI 911J £31 »E7 lJ3t tin 

2ti m im mt 232 us nii leie 

m iC9 ^141 1«|| 233 nil lllE 

mm Jill llll mAi/t nil Jill 

iiaiCB 1111 Z33 m llll llll 

nsfiCB mi nil ^lEO nil 1EI9 

iuH^ ]m IMI 238 «£E 11J8 111! 

217 «3 nil nil 239 tEF nil llll 

218 (Dl llll BI8I 24B IFI llll IBH 

n9 m 118] aesi m sfi uii ii8i 

?ii m im m% 242 if2 nii iiii 

211 f[>3 1181 m\ 243 4F2 llll 8>11 

212 tM nil 1118 244 »F4 nil llll 

ziatoa nil iiij z4stFf uii lui 

SMItd 1111 nil »Affi nil nil 

2JS«7 nil ml 247 iFf III! 

zum im iin 24Bif» 1111 l$n 

?i;iD? im IIBI 249 <f9 lUl 111) 

21S IDA nil 1I1B 2S9 4FA llll 1&18 

219 113B tl81 Llll 251 ift llll llll 
?2a tDC UII 11»8 252 4FC llll IJ8I 
?31 m im 111] 2^3:IFD ilU llll 

222 IDE 1181 llll 254 IfE llll llll 

223 tDF nil llll 255 «FF llll llll 



PapC-l 



Th* W1C-Z% hft5 fl fffalurt whith allows k prD^rani in ROH 
«tArting at tAfl-SA 1449611 tc ane control a* Hi« macbina it powflr-up 

At powei—up one d* the ver^ first tFongc th» iiperiting 
^/Bte- dM* w checK Witivi chirirtEr wiwinci etirting it 
iQCfltiort *Aafl4, H it finds *41,»3*,JC3.IC2.»CD it will autDmaticiUy 
jump to the aOflrflSfi it found it *A*e8i*AMl. A Bicond address is 
stored in IAee2,IAa03. Thic is the iddr»s d4 tht [RESTOHEJ Ksy 
processing routine. 

In crdsr to create a cartridge vith Held Only HeinEjryF it wiU 
bfl HEcessary tc havs a prom programmer. This la a device which 
"bumB" PROHs. PROMs ire progrimmable read only meirtoryfi. A PROM ma^ 
be orogrimmed or bixnerihy applying the proper voltigMind following 
the pTp scribed -timing rules^ Of the OflViu Ekeing prcgranmd. ThcW 
■functloaE are carrfully controlled wi^ « PRQH progrimmir. VificUs. 
Murces txist i^u devicei ^ it not horribly difficult to 
build your own if yau hive bdiiib ilectronic skills. Several mch 
projects have been described in the popular computing magafjn&s. The 
fflG- cnntainE the Twcessary information on Ihe BlecTrical flphni-ticm of 
^tt expinsion port where the cartridges attach to the VIC. 

Baine of the ojrrently aviilable cartridges actually cimtau-i 
BA3EC programs. To do thist they 6o the BASIC BStup routines in 
machine Unguaqe folltiw^d by putting "RUH" followed by tl3 (cimige 
retuml in the bASlC l^yboaN buffer it £31-«4e ind Jumping to the 
print READY routinf. The fodlowing tHample time out of euc^ a 
cirtridgii 

PLA fiESTORE KEY PROCESSiNG 

PLA 
TAX 
PLA 

RTI 

JSP rVlNLlNE PROCES£]N(j 

J3R 65»I7 

CL1 JSR 5845? 



Innd* Tht VIC 



JSR 5927* 
JSR 5B372 

LDA HI 13 SET UP STftflT OF 
STA 43 MiSlC TO BE 

LDA 41873 

LDA me? 

STft 888 DISABLE STOP KEV 

LDA 49888 CHECK FOB lECE^BS 

LDY H9 

CMP ni62 

BE^ il*2 

LDV ft3 

STY 198 » C^4aiRS IN BUFFER 

LOOP- LDA TrtSLE,X 
STA a3a,Y 
DEX 
DEY 

BNE LaOP 

JNP 50292 PRIhfT HEaOY 
TABLE EDU 41656 

BYT -«5 3093345333*45 ID 580 

TTie in*orni4tion in the Uble is SVS4E4:RUNi:Rl in dbbrtviatfld 
com m*nd formal. The BASIC program slarl* *t 41*73. Variable fltor4<j# 
will Btill be in W-mnrnwrPAH* since IhoM pmntetS Wtw f»vtP 
disrupted from the iini* of vtrtor iTiitialiiMtion- 



figaD-1 



Kex D^aniil 




B-2 




3-4 


8883 


S-<4 


B»t7 


7 




B 




? 




10 


8fleB 


n 




12 




13 




14 




15 


eei8 


16 


BBIJ 


17 




IS 




19 


eoi4 


28-21 


00 Id 


zz 


86 17 


23-24 


BBIP 


2S-33 


60 £2 


34-35 


96 24 






38-42 


8028 


43^-44 




45-46 




*7-4ft 








51-32 


0035 


53-54 


0037 


55- 5 i 


8939 


57-53 


SBaB 


s?-6e 




61 -62 


8e3F 


63-64 


004L 


65-66 


»043 


67 -da 



pLnction 



U5R f uTKtion jump 
Float- Unteow 
Inte9»r->^loai 

Sup btwn qurtvi flag - ft -at: dvUnvtlT 

Column po5 of ci«or on line 

Verify -frLag <8=Lciai/l= Verity) 

Basic inpjt buffer pointer/ isubficr-ipts 

□IH flag 

Variable ^iag - typt:FF=slring - 80-numeric 
Integer flag - type^fifr^ integer - 00-floating pnX. 
□ATA KM *lag/LIST q^ote #lsq/tii*nary flag 
Subscript flag; FNx fUg 

Flags for trputorreall «=input - 64-get- liS=read 

ATH sifln fUg.canipiriSQn avAluilian fUg 

Cupiwi 1/0 deyjfs for prompt aupprtst 

B«sic integer aiJr.(*or 3Y3 - GOTO •Id 

Tvnipcr«ry string deuriptOT eUcK polnlcr' 

Last temporary Btring vector 

Stack of descriptors for temporary tttHn^V 

PD^rrter for number tracwfer 

MiBC number pointer 

Prodct area for mult 

Pointer to ttart of Basic 
Pointer to end of prog.stArt of variolas 
PaintiF Id end of vaniblts ttirt of irf&rE' 
Pointer to end of uray g 

Puinter io itaH of aiSive vpctfconing dwrt 

Folntw- Id top Of kHM vtrrigft 

Pointer to end of memory 

Ctrrent B4Stc line number 

PcBV BASIC line nun 

PreviDiJ* BASIC statement (for COMTl 

Line number - current DATA line 

Pointer to nirtnt DATA iUn 

Input vector 



IrvklillM VIC 



PigtD-a 



Hex 








,49-79 






71-72 


Curf^nt variAbls adrir^^* 




73-74 


var jdDie pDini^r tor r uH/fltSA r 




' □ r O 


I SAvevn&w op savB/cupr op pointe-r 




77 






7fl-79 


nisc. worvi irBA.iurKtion dot pointer hi -in 






woTR irfappojiTTer xo ETfOg oeurptn 




S3 


'I-Brtfl'tll n( HhnUB CfPTHA 


m 


B3 






04-6 A 


■lilmri utIim* Iw £ w^imt* 


9B57 




Hisr. ni iBifii'irsI ■tniviTH «w> 




97—1 fl? 




68 d7 


1 flS 
J n s 


Krjvfe ev^iutnon tPnnVTt painter 




\ 94 


r m>ft ] iijQii QTu prDpOvBTlDrT 






it rfn imi bl a trv il ? 
nLLUrnLrld IDT Hi 




L 1 ^ 




ee7fl 


1 J2 


LOW rtrrlvr iriiHlru* hir^n -irir< A f-j-11 ■ 

uLFiv Lh ucp i^jui jEJii ly Dy It for alh,i| j 




J13-114 


i-^asetie DUTier j^riQin/ Efiries poiriiEr 




I J 5- 1 3a 


oLDnn-ijeT otsu znir,Jf. - Va'poinwrtCHAnGOT) 




1 43 






■ ■fi 


G* .'4, |ta ST 


8991 




Stop [tty-fl J.n^ KgVawi'trh nlfl 






■ iiiiirK| iDnsiUTE tOt eADc 








6994 


He 


ScriAl futoLit /dfr^rr t H ^-h^p 






aerLdi ofltcrPtQ cniricter 




I5fl 


1 d^W ILL/L rBtVU 


6^97 


151 








■1 nnsn 




t 53 


inpuT □PvicriT noriiLiuii b 






















J 57 


OS me^s^ fl^g - dliYttMfit - rui-« 


e§?£ 


158 


Ca^sdle ftPTOf piss i 




159 




00^9 


\6e-i62 


Jifty dtxK (HMU 




163 


Sp^ai bit CMjnt 



tMMim VIC 





Dicimal 


Function 


— — 


I&4 




— 

Cyda c□u^-tfl^^D^ ur-idl J/0 


BBAS 


1 <4S 

1 B<v 




CrrWwn iar tjp* w*it» 


UBAi 


1 Dp 




CksH^ buffar poiMvr 


■BAr 


1 




M-232 input bit %iafA^/rm- &^zni 


««A8 


1 CRJ 




RS^23? bit mt in/ Tipi riaii mw 




1 .49 




RS-23E flig start bit cM/Taps rd bit eir 


9af^ 


179 




RS-2az bytP buffer /Tipe rd mads 


aeAB 


1 ' 1 




RS'?32 parity storigc/Tape ctiKauFn 




1 "79 


-1 71 


Tape start addr/tipe buffer / scrGlling 




1 

1 1 ^ 


-1 7S 

1 r ^ 


Tape erd iMrftrvl ot CLTTfint progripn 




J r O 


-1 77 


Tipt timiog con5ta.nTi 


8BBZ 


17S 


-I 79 


Addr c-f tape buffer 








R5-2a2 trajwmitter bit cnt out 








trannnittBr nut bit to br Etnt 








RS-23Z tranfiirittpr byte buffer 


ABB? 


1 Q'? 




Ungth of cufperrt filv string 




1 ft4 




CjTGnt iogjcal file numbw 


ABB? 


155 




Cum secondary addr - or fl/W cDnnand 




J8£ 




Curr dBvi» numbfir- 


8BBB 


1B"7 




Ad<]r Dt Ctrl' file nimt string 


aeBD 






PS-232 write shift wopd/Hraivt input char 


BBBE 


* ' w 




iblcckg reniainar>g to rtAd/Writf 


■SBF 


191 




Eeriil word buffar 








Ca« flKrtor int«rlocR 


BfCl 




• *~ 




Baca 


195 


J J U 


ESPHAL Hti43 poirHv 


«flC5 


1 97 




Hft'lrix cD-'Oralnt'tfcs Df KiV pnu»3 




19B 




llQf chartrtcrs in Kflyhrri bijHtr 


eec7 


199 




Rtvers* made #lag - 8=off - IS-an 


68 CS 






End qI hna for input xiri**'* 


BeC9 


2ei- 


282 


CuTfior ingtrow - column) 


e9CB 


283 




Whach key - 64 if rxj key 


Da pp 


294 




Cursor Dliik ertabi*d +lag - fl=Ofl-l-irff 


BBCD 


295 




Dilay before eltut blinks 


»8CE 






Oivicttr mdtr cursor 


09 






Conor on/oH blinic flaq 



























21 








2U 




QuqTi fThftrip flan Man^i t LohhI 




?j 




Line ipngtn tor ^crevn ^£t-44.'oa/va} 




21 'i 




screfn iinfr number 




21^ 




iQT^TI uaLiiK L«^4- _____ 


eeD8 






" OT insens ouTSTsnDing 




2i: 


-241 


ocreen jin* iinK tiDlB 








>u-iwn row mirKflr 




243-244 


ScrBpn color 








eeF7 


2*17 


-246 


Pointer ts PS— 237 i^n'«iii/D Kj rftT BiJi^ii 




249 


-25& 


rainwr tn Mia-zaz trAqEinltter buffer a,Mr 




251 




Free zero page Joc^iions 




255 




BASIC ^tmDB 


eiae 


25* 


-266 


r lun itrig id ft&i^ii <rt»OrK ire A 




2^6 


-318 


1 nije crrDT log 


eiae 


25 i 


-51 1 




0298 


5! 2 




PTil^ir* inniit hi iXCnn 
OasIL. JPiyui DUTrPr 




691 




LOOltdl "flip riEcnhffr tafila 




£11 


-428 




B2£D 


^21 




aiEonaary aaor or K / UP cind — table 


8277 


631- 






623] 


641 


*6*i 


siarA Of ineinDry 


e2B3 




Tod of 'nwnaev 


8235 


645 




EeriBi "tiirrtout'-^ifi 


8281* 


64 A 






m? 


6^7 




ui Jl Mil Lirior unQEr cursDr 


0288 


AUS 








649 






G2^ 


65B 




nepsat Tiag - v'curcor only ~ 12£=al] Keya 








i^ia? uifTurr rvpEdT OClLTK 


B2QC 






ueiAi' Qtwi rspcftta 


e28E} 






Shift flag 


e2ee 


654 














fi57 




Shift nQd0SMit(it-«^r>abi»d-i28^lDdQKi 




65S 




Aolo icreoi tfvn fiagC«-on - < >l=off J 


&2?3 


6^9 




^16232 CEWtro] rrgiiitfr 



P«g«D-S 



Hvx DECinal 



Function 



8294 
8275 
B2?7 
«2fG 
B29P 
6298 
82 ?C 
B29D 
B29E 
829F 

fi2r^l 

8?S2 
B3fl^ 

B3as 

B38€ 

e3e£ 

83eF 
8314 
8316 
0318 
83LA 
t3lC 
031 E 
132a 
9322 
0324 
B32d 
8328 

e3» 

832C 
832E 
1330 
•332 



669 

66i'662 

663 

^^4 

66? 
66B 
669 
67t 

671-672 

673-7^7 

7Ae-7^9 

778-771 

772-773 

774-775 

77A-777 

776-77? 

788 

7flJ 

782 

7B3 

786-789 
7?8'7¥l 
792-793 
794-7P5 
7?A-797 

BB«-eat 

882-883 
604-885 
886-887 
888-889 

eie-8u 

812-813 
HI4-Bi5 
816-817 
818-819 



PS232 Cam mind reqisier 

Hon stafidard(bittiinB/2'ltf) 

P5-232 status ngistvr 

Hunber trf bit« to send 

Baud rata fliU bit time 

R3-232 end of rec<iv«r pointer 

RS-232 BtiPt receive buffer 

RE-23? start trinBnil output ttirf 

HS-2aZ end of trintmit buffer 

Hotds IRQ. during tape opBraticm 

Pnogram indiptcts 

Indirect error routine 

Indirect vit^n start 

Indipict crunch BASIC 

Indirect token print 

indirec-t rw tcMn 

Indirect Bynbal fvoluatlfin 

Temporary storige during SYS ot A-reg 

Temporary storage during SYS oi X-reg 

Temporary storage during SYS of Y-rtu 

Teinporary 4tw-age dlring SYS erf P-reg 

IRQ vector 

BRK vector 

NMI vector 

Opin iDgicil file vpctor 
Clme iD^l file vftctcr 
Set input d« via vecfar 

Stt dnafi vtetor 

EleMt [fctiUlt i'/Q 
[npirt from device 
Output to (levies «clDr 

Tefl-t STOP hey vector 
Ot\ from keyboard vector 
Clo«e ill filii vtctV 
Ba^lc IT^ command vector 
Loa-d front device vector 
&an to device vector 
CUHtlt buffer 



ImUiTlH VIC 











J V ^ ^ O T 






rVHliJ rLPiJ 












tJ 1 T£ I O-Jff 3 


8K e]<pan5ion RAM/POM black 1 






J If ftpinsion rtfln/nun diocK I 


u V n u 


7 4^7 *— ^ 9 7 *4 


tm e«pansi[in MAn/MLrpl dIdcK 3 


1690 

J V u V 








9- 


uacr aasu arp* ^r/^n / ijju 


7*1 BP 




CdIout ram LSAH > SK> 






4K tfiander gsrwrdtor POM 


8600 


3? 7 AS- 33? 9 


upper CAH 4tno orspffiKs 


8400 


337"92- T-IH 1 ' 

WW f sJ-lJO ^ 1 




Bffl R 


J JO S Ovi- 






ootto* -J ' tJH 1 






Jo □■O'? JOB / J 


AddrBSQ o+ VIC chip r»Qlsten 


7 D 




□iti fl^fl-horLz nntmg/DiT Tdntiriiu 


?06 1 




vvf iicmi CvriTivrinu 






kml^vA faiAHuT fl—J.^ ^ F 

bits B-fi:* CQU/bjt 7 part o-F scrn mem 






Dita I'fi.M rowsAbit 6 His fl^Ei or lisS chars. 


9964 




1 V PASTer DfAlft ilnE 


90BS 

^ V O hJ 




Dits -B-J start of chdr^ictcr memory 


90 B A 


JOOr D 


noruQ-it^i pQsitiDn af .light pen 


9997 




wrucai pafeiiton Of JiQn^ P^n 


TD DO 






?0e? 


36B73 








Krequenrj' ToroscjUator 1 (low) 






!*rtqueT\Cy tor DSfillator ^ ll^^□lLKnl 


908C 


<tJVKJ r 1-F 


p rp[|i_iency tor DsciiiatDr s inicnr 




OdC / ' 


FrequBncy noisp Murce 


?00F 

V t# U ■_ 




□life P'j-vDiuine/H-i .iUHiiar/ colcir 




3i87P 








£522 VIA Ha.i 


91 IB 




port B DutDUt rsrai^tsriifssr mrt RS?37} 




37137 


'frri A nutput register 


*n2 


3713e 


Data dirfctjonrr^iatflr B 


9113 


37139 


&ita dlirectian register A 


9J 14 


37140 


Tidvr t low 




37141 


Tir»^ 1 h^h &yt» 





}flciinal 




Function 


. . — 

911* 


— 

37142 





_ — i — ,-, — 

Timer I law byte 


?il7 


37143 




TiiMT 1 high by^ 


¥118 


37144 




Tim^r 2 low- byt* 




37145 




Timw 2 high ftyte 


>iiA 


37l4i 




Shi*tPKil5ter 


91 IB 


37147 




Au* iJiary control register 


91 IC 


37149 




Peripheral cnntrnl registsr 


91 ID 


37149 




InterrLipt fiag rsgistfr 


91 IE 


37156 




Interrupt enable register 


9nF 


37151 




Port A iarrse cissettp switch) 


?i2e 


371 52- 


37L67 


VIA NtJp 2 




37152 




Pari B output regit tir 


91 ai 


37153 




Por-t A output regiatttr keyboard pdw scan 


¥1Z2 


37t54 




Dita dir«ctlar ri.givier B 




37155 




Data direttinn pegio^ A 




37 ISA 




nnerL]owby4«im 


9l^5 


37157 




Tiinar 1 , high hyte katch 


9124 


37153 




Timer I. low byte cixjnter 


9127 


37290 




Tirner 1, high Ciyle counler 


9120 


371^8 




Tuner 2.1dw byle latch 


9129 


37161 




Timpf 2. high byte latch 


912A 


37 




&ii4t regisler 


91 2B 


37163 




Auxiliary cnntrol regisler 


91 2C 


37164 




Peripheral control regiEtar 


¥12D 


37165 




rnt«rr\«t -tliq reglstflr 


91 2D 


37165 




Interrupt enable ra-girter 


91^ 


37167 




Port X output regifitep 




37338- 


33399 


LDcation trf COLOR RAW ISAM > flKJ 


9&06 


33406- 


3691 1 


Normal iDcation of CCH-OH RAM 


9666 


359 12 




1/0 block 2 




39936- 


48^^59 


I/O blocks 


A866 


4691^6 


49151 


E>:pan9JCin ROM 


case 




57543 


BABIC 


CB0e 


491 5Z 




Keywix^ action abdresHS 




49222 




Functian actinn addresses 


CB74 


A92iS 




Opfirator action iddrtftfti 




A929^. 






cm 


4^5S 




ErrdrnHFM49» 



iraUiTtwViC 











58 a 58 




C3Be 




V|iGI 1 IIIEillUr J mflmLC 


C3FB 


58171 


Tbe1 stack derjth 


C«BB 


581 Ga 


Check iVAiiabls namrv^ 


C435 




Svnd ^rror iFiBSftiav 


C47^ 




Print READY, 




58387 




C533 


5«4fl3 


3A^C line chairdiHi 






RardtiB llna- JninH 1'--^- -I . J 


C57C 




Tdteniztt l!rw 




Se7-B7 


EtiMTVh tnr* Tina rni iKk<iH 




56754 


Ferfcrm HEU 


CA6& 


56794 


Pfirform CI R 


CfiSE 


58838 






58644 


Perfnrm 1 TCT 

■ ^1 1 ui III wJwX 


C74a 


5iet0 


f- ?l 1 UN III f Ufh 


C7ED 


511SJ 




CSID 


5122? 


■ E| ■wriit ■hLAj^i UET EL 


ca2c 


5J244 


-rep iLJi III 3 i ur oipfl riJJ 


CB57 


51287 




ce7i 


33313 




CB93 


51331 






5l3<£e 


F h q F v> iph ^^^^ J 


C8p2 


514] e 


pBrfnrir RfTTTTBU 
• '1 iur Ml n& 1 unri 


CSEB 


5J435 


PpMnrm TliT J 
r cnui m J J\ 


C9aA 


5l4i2 


u^Bi 1 TLn 1 itf ji [ SldEePrEFIT 






Ftciiri Jiyh i-iai'* ii— — 
Ln-flii TLn ne^T llTR 


C925 


514P6 


1 ^1 J ui 111 If 




51515 


P9ftarm RRH 
■ ■ III i^i^n 


c^a 


31531 


perform ON 

n 1 1 1 LI 




5l5,i3 


'■■'■p^+ UIIf E 


C¥ft5 


51^1 




CA8e 


SI 844 






51841^ 


Pepfami CUD 




51 


Perform PRINT 


CBIE 




Print string -frDHt *ny ntvmQTf 


CB3B 


52827 


Print +Driia*t character 


CG4D 


52645 


Protess bad input 



BbMbTM VIC 



Httc 




Function 




CB7B 


52BV1 






52333 








Fn-tirnlHPUT 


m9 


52217 


Prampt & in^iA 




52238 


PvHarmREAI] 


CCfC 


5247A 


Input error messd^tts 


CDIE 


52518 


PeHorm NE-ITr 


CD7S 




T^Cjp match checK 


CD^E 


52^38 


Evaludte eKpreesian 


CEA8 


52984 


P[ in flcuting point 


CEFl 


52977 


Bvtiuttc within F»renthV3i4 


CEF7 


52983 








Owdt^or"!- 


CiFP 




CHetHfof" -■ 


CF«e 


5^88 


BynttaK Errnr 


CFM 


53Q12 


Gea.rch 4x varublv runv 


CFA7 


53159 


Set up FN r«tBr«ncn 


CFE6 


53222 


PtHorm OR 




53225 


Pcr+arm AND 




53278 


CorrparisDfi rootin* 


Da7E 


53374 


Per for in DIM 


[^SG 


53337 


locAtt variablB 


Dl 13 


53523 


ChFCH for alphL ASCII 


GJID 


53033 


Crt ttf nvv vu4<bl* 


DIP4. 




Array pdrrtvr rwtiM 


D1A5 




32768 in -ftoiling point 


DlflF 




TACi tc integer 


DIDI 


53713 


Find or Cr^atfi Arfiy 


D34C 


54892 


CompLTte ^ubttcipt ila 


D37D 


54141 


FflrlDrm FHE 


D391 


54 UI 


Integer to FACi 


03 9E 


5-1174 


PerforcP PDS 




541 8Z 


_j _ ^^^^^ 

ChecK^DIRECTmDdv 


D3B3 


54195 




D3E1 


54241 


ChecKFH Kyntu 


B3F4 


5«!fi| 






54373 


P«^<M.8Tllt 


ff4^ 


5438? 





Intld* TTw VIC 



fwJE 




Function 


^ d 


SdilB 7 
jM*f in / 




D4P-4 




Hl!lrf <-l^lflil ii»r>ni» 

■Hjiia kirnig VeCIDT 






Coilect gartigB Coila raw 4ip ctpiRflJ 




5471 7 


unech siring cOMctlcn #ngitiil|ty 










54 9 1'^ 


^nr^r A ^Dv^^ j- 4.1 r 1 

WDrHdiErUTB STrjng 






DLfljo Siring id memory 


DAA" 


=ii947 


uiscara uriwAnlffi string 






uiBan ifte tieBtriptor ^idcK 






j-Ertcrm LHRa 






rBrTGrill LCi r i * 






F*BPtfjrin Rights 






nW" TLI In HILW 


D76t 


S'll 17 

w U 1 -i_> f 


r^Jii iTP]r>g ptrulCteri from stack 


D77C 




r#rHHTi Lbh 




331 r U 


Wsit string mode 


D7ep 


■jjt 1 y 


rerform ASC 


D?93 


551 9'i 


input Dyip parafiiett>r 




5571 ^ 




D?EB 


55275 




D7F7 


S52a7 


r flLi to intiger 






DhkA^u^h^ D0 Bit 

rcrform ptsek 




35332 




[>8?b 




ropfdm} WAIT 


[1849 












D9iiA 












DP7E 


5567B 




V ^ WW 




Singl? byte mLiltiply 






r iotung piojnt con^tanls 




5378i 


rwrrnrrn Ltfti 






nuJiTply FAC] t nffmory 






HultiDly FAC? f (TACI 


[M99 




>|L4tlpJy a bit 


IW8C 


55949 


^•■CirytoFACi! 


0AB7 


55991 






56024 







FmctiDn 










aou J** 


HuLtiplv ^ACl br 14 






Constirrt 16 


iMrb 




DiviilE by 1ft 




JBD / J 


Divid* KACZ / Mtfory 


UDBr 




DxvidB iiwiihory / FACl 


nDi '1 
Ulf 1 J 




Dividt FAC2 / tACl 


DohZ 




Htnrr to FACl 






FAC1 to naiHry 




J B 


FAC3 to FACl 




ye 


FACl to FAC2 




Do dlr 


Rot^ G+f FACl 


DLZd 










Pirfarm 5G-N 




^ J rid D 


P^rFvni ABS 


UL3D 




Comoire FACl to mEmEry 






FACl to intvQep 






Pirfcsnn INT 
















SA7^^ 


Confiturta 




■1^797 
uDr r f 


FACl to ASCII 


ur J 1 


3/ 1 B □ 


Hot* cnnsttMs 


Ln ^ J 




pHrform SOU 


Ur f ii 


S7?HP; 
£116' 


PtH O^ii* All ponintiAtiDn 


Urol 




Perforni ne-gation 


UrHr 




More CDTfitiiTti yti 


UrtL' 




PBrforn EXP 




arlBD 


SariiB tvilitttion 






■-T^"^^* F^l "^^^ ■ ■ 






■ ^FT ~ ™ ' ■ 1 ' ^^F^^ 




■f jji^M^ 


hrfcrn COS 










■(8033 


PtrfornTAH 


E2DD 


58877 


CDHEtants -For trlff function 


E3ee 




Ptrforn ATM 




5B17] 


Constants for ATH 






Imtiilin E1AK victn 


£307 




OiRQBTfirHraFMgff 







CHAM 




Crtr 




b4*p 










coca T 






t*lflT 












C3flV 












tsi □ 










587] 9 






baa/ 


58759 






baLd 










■-jinB-n 






bold? 


□ tB f r 


QOCn 


1 1 J 


t ' J 5 


3r J 3 f 


b/fU 


E g. Q 1 
3 rl 1 




^Q?B ? 
J7lO £ 


bDL-J 




EaDB 












pal 4 




bj<El 




E9Z9 




E975 




E9EE 


5 988 A 


Ef^Sd 


59999 







HriHgfs 

Program p»tcti »rtt 
S»fHl output 'I" 
94riAl output "I" 

Hrial input t docK 
Prapvn pitch irn 

5Btd5Z2iddra 

SbI Kmn Units 
T^kK OTMr li)»ti[vi 
iRitiftlizi I/O 
NDTDialiit KPttn 

Home nraor 
S«t ficreen pointtps 
Stt I/O defaults 
Stt vie chip dtfujltt 
Input frnm ictybovd 
Input tWI Htwttt 
QuotB nartctattl 
Bet up icmn print 

R«1re ti cursor 
B4d< inta prsviouB lint 
Output to 5[f*en 
Go to nest lire 
Do 'RETURN' 
DiicK hrw dtcrtntnt 
ChtcK line incnmBRt 
Set tdlour code 

Cddv taiV«rs£orl 

acroll ur*^ 

op«n 3pux un fow) 

Syndi odcHjp tw*f«r< 





FtMicticin 


— 


— -~ 


ch^ «tij*t*of~linv 






Clear scmn lin* 


E^l 






EAM 


40074 


EtoTf on scmn 


EAB2 


40032 


Bvndi colour tcs dWT 


EASF 


da093 


IfitepPLDt QRGJ 


au 


Mm 


□wdiKiTbciird 






8«t tVKt Mdl 


EC4« 






GC*S 




Ifevhurd nam 


ED21 


68705 


Oraahir^/tBitt cortrOl 


EDSe 


4e7?a 




ED?B 




Up AO LID screen Itrw 




4^8779 


chiffaH icpv matrix 




49935 


rruvtrai Ittv mitriit 


EDE4 


407fla 


Vir thlD itofuiltt 


EDfD 


499Ea 


QrHiir\ lirw utdft- low 


^4 




tell 'iaW 


EE17 


MWl 




EElC 




IBVJHI UNii»v4 ■■■■■ 




61801 


hnt in wrUl bun 


EE87 


1^1 111 


Tin#aut on sd^Al 


EECe 


ill 28 




EECS 


41125 


Cl-Btr ATH 

■■B ■ ■ I ■ ■ ■ 


EECE 


lulls'; 


Send talKSA 


E€E4 




So-nd uriAl da-4imd 


EEFd 


41L74 


8md 'intAlk' 


EFfl4 


41106 


Sarvl 'uilictin' 


EPi? 


A1209 








d-ocK llTV on 






ciKKim off 




A 1334 


uwiMf 1 ins 


EFA3 


41347 


RS2a2 Hnd (HHH 


EFEE 


41422 


Nevi B&332 byia wod 


raid 


£1462 


Brror orqjlt 


Ffl27 


6H79 


Compute bit count 


Ffl36 


£1494 


RSZaf miw (NHII 


Fess 


61531 


Svtup tcrflcnve 



ImidiTht W 







Functjon 




Fe^D 


A I 5S7 




FaA2 




Receive DverritfT ennor 


F8A5 






FaA8 






FaB9 




oAJd rip viri^ 


F9BC 


61 628 


File to RE23? 




£1£?7 




Fl 16 


61718 


InOut 4FOa RS^as hi hffi>f^ 
"'r"** Tiuin nanif o.w'THr 


Fl^F 


£1775 


Oat imm RS232 btiffer- 


F16& 


61 792 


ChPrK Esriil hiH f rMb 


F17fl 


61812 




F1E£ 


£1922 


Print if dirwi 


FIF5 


£i94i 




F2e5 


£1957 


..■from RS232 


F2aE 


£J96£ 


J li 

± 1 qJ IJ L 


F2^0 


62032 


Get . , taoe / 5eri&l/RS23 2 




£2674 


Output-, 








F2C? 


£2151 






62217 








dost 


F3CF 


62415 


Find file 


F3DF 


£2431 


Set flip va1iv4 


F3EF 


£24*17 


Abort iU fi1p«i 


F3F3 


62451 


RtS-tarp default I/Cl 


F4eA 


£2474 


Do filp Dwnim 


F495 


62613 


Send SA 




62£63 


Oper H5232 




*278£ 








^SE ARCHING^ 


F(i59 


639 £5 


JVint^e nA.DE 


F66t^ 


638 8i 




F675 


£38 93 


5a vo pmgriin 


F729 


63272 


^SAVING' 


F734 


£3264 


Bump clock 


F76e 




^t time 


F7i7 


£333S 


Set time 


F77B 


63344 


Action slop toy 



Mtfi tilt VIC 



PlfftD-13 



Htk rHim 

F77E £3358 

F7AF 63^87 

F7E7 63463 

FB-I1D £3565 

FB54 £3572 

F867 63S91 

Fa94 

FSB? 63671 

F@ce 636Se 

FSE3 63715 

F8F4 £3732 

P94B 63SS9 

F95D 63937 

F?eE £3966 

FW*D 64173 

FBD2 4^464 

FBO^- SWS 
F6EA 

¥C9S £4518 

FC9B 64523 

FC95 £4^61 

FCCF 6171? 

FCF6 64758 

Fl>ee £477£ 

FDU 647B5 

FQ-IB £4795 

FI>^ M^%2 

F&Tffi 64K« 

FD90 £4^B? 

F[>F1 £5889 

FDF9 65617 

FE49 i50V7 

FF59 £5184 

FE57 £5111 

FE6d £&l2d 



Find arsy tatw header 

Write tape header 

Gel BuHer Address 

Set buf+er start - end poinitera 

Find specific header 

Bump Up* poin^flr 

■PRESS ?u<y' 

'TOESa RSeOflC 

TnitiatB taps r^ad 

Initiate iape wriie 

Campion lap? r^sd^writE 

Ciieck tape step 

Set timing 

Dead bits (IRQ> 

Btore characters 

Rnti pointEr- 

Hew tape character setup 

Togijlfl tape 

D&ta 

Tape write [1RQ> 
L?±der write flR&l 
Restore vetlors 
Set vector 
Will matdr 

ChECh r*ad/wri-te pointBr 
Bump read/write pointer 
Powwtro entry 
Ch»CK atdbi 

SetKBFTiaia: 

IRQ vectoris 
[nHiali» I/O rvgfi 

Sa¥» data nama 
Save file details 
Get atfttus 
FUgST 



imUfmi VIC 



PigiD-U 





I>tcimal 


FEdF 




FE73 




FES2 


■65154 


FE?I 












FEB£ 


^5244 


FF54 




FF5C 


.45372 


FF72 




FFSrt 


^54ia 


FFFA 





5flt timeou-r 
Read/sel lop "le-mopy 

TBSt memory locjtioii 
HMl irrterrupt enfry 
pESET/STQP warm starl 

Mil nS23Z ECEiLwncEa 

t^EBtcii-e 4 en it 

timing Uble 
H4ir> IRQ entry 
Jumbo jjmp table 



- 



S«inpla Bl^—Maispvd plowing 

Th* ftjUcrwirrg program^ itf-^ ir\ euample o4 a mdchirie lAfi^i-uge 
UibrCJUtirKr riall^bJe by either BASIC or rnachine language ^ arKl a BABIC 
program which incnrporates and u^es Itie rouiine- TKe machine language 
F^gram designed to "(um on individual pLirels based on a !{ and y 
Wt-pOBition passed ^roin Ihe calling rou-tine. The routtne as^umES 
that the character pattern table has been set up tn ^tart ii location 

ThisicutdE an CQU labeled CH. C^AngUq the EQil udl thil 
is HKeuary to change the routine to use tkno^vr^ -IKA- T~t 
aSBUHK tiiatthfeKandybit.po^tionstr^heBFistoFVdiffnimbBfBin 
Hw r*ngB bf *-lZ7 in lociifions 1 snd 2. Tnt tjppar left zmttr of 
Ure^ ii CDnsid^red pit position 6f9 and the lower right Ifi position 
{271127. Locitian zero i5 used as a mode switch. I-f ^e valup 
contained thtpt is ^reiter than lZ7i thepixfl:! at Iht specitird 
coordinates will be set on. If it is l<ss thari 128 -H>g mode is erase 
and the dot will be turned o-F-f. 

The BASIC program \vfiich caiLs the plot routine has'the 
responsibility o* setting up the screen parairieters- The character 
rnvnarv i« Ht up to flf^ at 5120 ^ ttv irrccn mD-mory ia Ht 141 to 
iMgfn at W4. The «cnwn«ZB la Wt at Id lines by 16 cokinng. All 
of tfiesE funttidns art atcoraplx^d witTi thBfoir POKfisifilinfl 1«5. 
Tht fortgrDund color ia Mt at blab" for ill kiwi posltiara bjr 
s<tatement tlfl. The screen codes are pre-initialireri to the top 

!*ft corner of the screen having value ft and the bottom righ-l having 
2:55. ThiB isdofw in stitttnent 139, Stale me nt 14ft and iSfr are the 
inainline of the progrdm ir\d Skmply ^ause a hne to be drawn from the 
upper left comer to the lower right »nd he erased repetitively. 

The BASIC progrim: 

IK POra d^mi29'i-- PCSE36Si+flJ= POKB 3£e£5,36: POKE 36&6&,\6- 

ii« FOR I ■ 37866 TO 4 5t5: R}VE IfEXT 
I2« FOR I - 5i2B TO 7lfi7: POKfi I.fl: KEJT 
131 FOni - 499iiTO«9i+ 255-POKSM - NHXT 
144 POKE »,12S: GDSUfi 15»: POKE GOSUB GOTO 144 
15ft FORI - flTO 137: POIH I J: POTE 7J: BYS 9«ftft: HBICT^ 
RETURK 
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Th0 marhine lin^jigc pri^ogrim: 



1 MODE EOU a 

2 EElU 1 
a V¥ EOU 2 

4 LO EQU ? 

5 HI EQU 4 

6 CM EQU 5126 

7 Eoy Tflee 

B LI>A He 

5 STl> <-HI 

19 LDA KJY 

11 nFS fl * IHTty/B> 

13 LP A^ft % 

15 DEX • 

14 BPL LP * 

17 3TA *-L0 

Is L[>A ^K>X 

tF8 COL-DTSP - 9 » IhJT (>L/ej 

2fl rtOC <-L0 * 

21 SIA *-LU # ROU + COL 

BCC. H h 

24 H LErt *W 

25 CLE 

26 AND tt7 CHi*R PATTEIW ROW 

27 ADC tLO 
?S BCC rt2 
2? INC +-HI 

3fl H2 ac 

31 ADC HCH ■ 

3? STfl ^LO * 

33 LEW mi * i^DDRESS » CH*DISPLACaiENT 

34 fiiDC llCM/256 * 

35 STfl •■HI • 
34 LEW tVX 

3? AWD «7 BIT POSlTim 

3B TAX 



39 










40 




TYft 






41 






* 




43 


ROR 


ROR A 




POSITION THE BIT 


43 










44 




BPL fiW 






4S 




BIT mODE 




SET OR RESET 






BMI ai» 






A7 




EDR (WFF 


• 




4S 




*WD tLO) ,^ 




RESET 


4? 




STft (LD),Y 


• 




59 


ORA 


aftA ILOJ.Y 






51 




STft (L0J,1f 






52 




RTS 


* 


flETURN TO BASIC 



Bi(fdanttion= 

TTw Bcrvcn HtA L6 rows erf i£ ^anc-ters each. Eich chinctvr 
hu Bigh-t rowB of »ight dnts vacti. Tri« screen rnvmcry corrtilrq ■ 
Mquential sti of rharacttr cDdesi -from 4 io 255- Thi firsi sivtHn 

t^e screvn- cades iride>E th^ divicter patterns which wilt appear on 
tfie top Linet the tecoTKl Bi>!t«cn rtttrsncing thr pattsmE which will 
dpptar or thB Mcord linet stc, EkJt charatter pattam ttfl ii Iht 
pattern -for thi upper Isft vight by i-ight block d4 dots and characttr 
patt»m k1 li th» blKKtotfWPightof that and chvact>rT»ttefn MIA 

is tfn patltfn of di^ for Oic bitidc.bctow tt «nd m fo^ tin 

illuBin»t«d ifithcbOltonhi#itcimer'Of so*«erti 

The iboYf machinff Un^gt lubmline computer which patterri 
correapondft ta dny givvn X and Y dot foorflinalr. It ilso computes 
whirfi byte within the eisht-byte pattern holds th# dot in qumtion and 
uriuch bit pca-ition within that byts to tuT^ on or off. 

The Y value rfipres^ntft how *ar froni the top of t^e an^en the 
M 19 locattd. II it U iJ^ the ran^e o-f S-7, the dot is in ihp lir^t 
row of characters. If » »8-15i it is m the second row. etc. Bote 
find Vw rov T must bi divided by 

tfuh rcMDf dura£tirccaitun& 16 p4tt?rns uroH th» ocrfKiind lAdi 
patt#m cDnUlmi tiflht bytw of data. So. fGPvv«7 rowi .tta position 
wlMn «H tdde kncreues by fl tim« 1£ or 128. 



The ftddrssa of -thi iwi'aprtiti bytt of thb ttble to nodify i« 
built in tht two-byte field Ubvlwj LO Mid W. St4i«nfc»ntm 1»-17 
mnpute the dispUnmvnt into th« tiblt dua to th« T vakn. Stit*iiwrTt 
11 %inptL tfw lEntnrdir ttrt» bill fm thi V-viha. Yliift 

uxdinplll^ both tht InltiftldlviBkin by e In findttit row-nuBbtr and 
thi multlplicilion by vighi. H now multiply this 'stripped" valut 
of Y by Id, ws wia gat the '■row-^iepUcinwrrt' into the chifictaf 
tA.t»l«. ThiKi* a)factly whit a-tatementfl 12-16 do. This is « fcjur-bit 
Ivft shift. Bver^ time a number 15 shifted iBtt orw bit tht number 
irKrc49e3 in valut by a faclorof two. So, ■ foup-bit shift is a 
iwjltiply-tay-l* operation. Note that the carry bit ie the 
communicjitiDn between -the two bytes of the shift operatmn. The bits 
wmcn oMne Off the lift of th» A-rt s get ihifted into tht bytt at Hi. 

ThiXvalut tells us how ^r into the row we Aiustgo toc^tthe 
pmpfeT Akr«ctfr<iM^1^)W. An 3C va^ of 1-7 would addres* the 
first chu-acWwiWnlherow. A v*lw <tf 9-t5woidd eddreu fl» 
second, e-fc. Dividing the X-value by 8 (fivtt the chiractn- positifvi 
within the paw. gich chir4cter has eight bytn of InfornitiDn 
associated with it in the pattern table, so we have tc multiply the 
character position biK eight to get the displacement into the row, 
St-itemint 19 effectively ucomplishDC both fLTictians at the sinvi time. 
It *lH.p5 the low-order three bits , which is lHiM chifting right three 
bits (diviEion by eight) then shifting bacK left again (multiplying by 
■iflhtJ. TM* charactw position within the row is adOed to the "row- 
dispUcenMnf previDUsly corhouted based on the Y-value. The r«Mlt 
goes back M)HI-LO. 

Hextj the brlewiimnlhechiraclerfutttm wlbt. tompAtd 
and added into tn«dlsplai:ement value being tuUt, ffuh byte d^thin 
the character pattern description descrtbes a diflermt row ot bft* oP 
pixeU on the screen. The Y v*iM mntiina the row infarmitionr In 
fact, the low-order three bits may be E*cn to be the "character row" 
value. They may have the value of Tb strip off the high-order 
bits, the instruction at statement 26 im employed. This v«lue ii then 
added to the dicpI,a[:eiFient. 

Nowi in statements 3*-35, the addreai of -ttie Hart of the 
character pattern tabl« is added tu the displacement within -Die table 
to get the address of the actual byte to modify. 

The only thing remtimng is to g«t the utual bit within the 

bytt snd cl^tuYi it onw off as indicated by ttw mode twi^ in 
IbcMi^nA, Thelbw^fT^thi^tlticiftheK-valuenaytwccVHidm 



InaMIM VIC 



p>ati-s 



the bit-fnsitioo. Etatenenta 36-38 ^trlp off the high-ordtr bits and 
^r'Afofer ttw value into V*e X-reg vrtwre it will beuwd U a counter. 
S^n^ite 41-4* shift ^ carry bit into the A-reg. ThB tarry bit 
will end up the HIM mubtp Df bit pMiUona from the left as the 
value cfBatBdift the X-rtg* TWsbyte can now be used to modify t*ie 
byte we have Just conpijted the position of. T^e BIT instnjctiGn tests 
m hiQh-trder bitof location • to see if n set or a reset of the 
specified bit is required- If it is a resell the hits iri the A-reg 
are flipped so tiie AKC ina-truc+icir can set the proper bit oft. Recall 
that AND nteds zercis in the bit pD?jtJ,ons which need to be turrwd o-ff 
and ones in the- bit posjtians which need to remain unchanged. 

If a "sef" is requested, the OBA instruction will accomplish 
the tett- FinaUyt WV return fmqi whence wt were called by the HT3. 
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BASIC Programs may be readily Ida fled into any piece of RAM 
large ersdugh to accomoda-te 1:h?m. In +act, many di-Tterent BASIC 
programs mav be in memory at thie samB time but in flit-fsrsrit pldccs. 
Tht pragram which La "current" in Ihe tyfitem at any one tirne 15 the 
□RE wjhich ifl pointPd to bv Iht "sUrt-ot-flASlC ppinter at A^M. 
Loading a prngram into in alternate location is simply a maltef pf 
chining 43jW toppjnt toihe addrtM where yoo wisft the program to 

To get IhB program to RQU it) the alttmattf apace riquirtf an 
additional operation. Th0 Byte imiMdiately precetding th« pmgram 
load iflflrtss must have tht vikjf|flfl\ Wi-thotfldoino ^fl, numrv 

the program v/ill prockice a SYHTAX? ERROP- 
5o, the procpdure is: 

POKE 44,>f«/?56: POKE 43f>i>^^-PEEK(441»25d: POKE >i»*-l,e:CLfi 

Wtwr* ncn ifl tha address you wish to lud the prcjgrim into. 

Witn SAVKlng a ppogralB, tte ftrt^ mtninrv spa™ between the 
addreiHi at 43,44 and will he SAVEd- ItU thus poaaiblo to 
SAVE multiple prograns h one larflff pwmtt'V liMtd- 



There tfw -ttir«e ifigrades poEsifalB tb tht Btindu^ VtrSion oi Dlvtlop- 

If you hl(V« AHlWttt-biud version, you miy e^ichanCB it fur the 
dlBkette vsTBiUTi. TlW disliette-baesd vorHnn supports Assembly and 
load module fUas on diskette as opposed to caisettE-based version 
which will only suppcrt cassette files. 

Tfya eMtended-faature version rfiquires at least to run ^minimum 

espaniion mcmmT ot 310. Its in*in htrwfita are the ability to 
rapidly between Editor and Atsenbler modea without hiving to^vt 'tiv 
Aneikbly progranr then leid j^Mmb&er WhlA ttutn W&U hive ip^ 
IgUj toe Aw»bly program. Tha ttflitor irei Assembler art cbmbiniid into 
m pn^vn* Tha other feature prtMdtd with the ck tended -Fa-ature 
v«r«lon U thi ability to direttly POKE the muhin^ lar^gua^e n^tput 
from the Assembler into the VIC's memory without having to save it as 
a Load module *or input by the Loader. The POKE option is adde-d to 
and flMS rotreplice the SAVE foilure o-F the standard v^rsian. 

The cost of tfis B!Xtendod-featur« upgrade is »l*.e9. Printer 
suport i^ aviilihli with the entendtd-ftatirr version for *n 
additional The dtsK version upgrade i« tSM- All feature 

optian prices are addltivfl. So dish arid extended faatins arwl ^5-732 

To receive the upgrades, you n*Kl only Wtum the original cacsette or 
disKetta along with ycxjr ihecH or money order (U.S. Funtis) or VI5A/HC 
nuflAcr/rxplrvtfcm data. 

Send the vagnetic media and the payment to: 

PX.BDXZt7 
£!arnn Faille HHSStM 

If you dd not wish tci take advanUge of the Kchvige offer but would 
liMe to be oti the mailing list for fuim prodijctsi send u4 your ram$ 
and aAlrtis. We will be tvapp^ ta mdude you In our futin aailings. 



